ID3D11Device ::CreateInputLayout, méthode (d3d11.h)

Article
02/26/2024

Créez un objet de disposition d’entrée pour décrire les données de mémoire tampon d’entrée pour la phase d’assembleur d’entrée.

Syntaxe

HRESULT CreateInputLayout(
  [in]            const D3D11_INPUT_ELEMENT_DESC *pInputElementDescs,
  [in]            UINT                           NumElements,
  [in]            const void                     *pShaderBytecodeWithInputSignature,
  [in]            SIZE_T                         BytecodeLength,
  [out, optional] ID3D11InputLayout              **ppInputLayout
);

Paramètres

[in] pInputElementDescs

Type : const D3D11_INPUT_ELEMENT_DESC*

Tableau des types de données d’entrée de l’étape d’assembleur d’entrée ; chaque type est décrit par une description d’élément (voir D3D11_INPUT_ELEMENT_DESC).

[in] NumElements

Type : UINT

Nombre de types de données d’entrée dans le tableau d’éléments d’entrée.

[in] pShaderBytecodeWithInputSignature

Type : const void*

Pointeur vers le nuanceur compilé. Le code de nuanceur compilé contient une signature d’entrée qui est validée par rapport au tableau d’éléments. Consultez la section Remarques.

[in] BytecodeLength

Type : SIZE_T

Taille du nuanceur compilé.

[out, optional] ppInputLayout

Type : ID3D11InputLayout**

Pointeur vers l’objet de disposition d’entrée créé (voir ID3D11InputLayout). Pour valider les autres paramètres d’entrée, définissez ce pointeur sur NULL et vérifiez que la méthode retourne S_FALSE.

Valeur retournée

Type : HRESULT

Si la méthode réussit, le code de retour est S_OK. Consultez Codes de retour Direct3D 11 pour connaître l’échec des codes d’erreur.

Remarques

Après avoir créé un objet de disposition d’entrée, il doit être lié à la phase d’assembleur d’entrée avant d’appeler une API de dessin.

Une fois qu’un objet de disposition d’entrée est créé à partir d’une signature de nuanceur, l’objet de disposition d’entrée peut être réutilisé avec tout autre nuanceur ayant une signature d’entrée identique (sémantique incluse). Cela peut simplifier la création d’objets de disposition d’entrée lorsque vous utilisez de nombreux nuanceurs avec des entrées identiques.

Si un type de données dans la déclaration de disposition d’entrée ne correspond pas au type de données d’une signature d’entrée de nuanceur, CreateInputLayout génère un avertissement pendant la compilation. L’avertissement consiste simplement à attirer l’attention sur le fait que les données peuvent être réinterprétées lors de la lecture à partir d’un registre. Vous pouvez ignorer cet avertissement (si la réinterprétation est intentionnelle) ou faire correspondre les types de données dans les deux déclarations pour éliminer l’avertissement.

Windows Phone 8 : Cette API est prise en charge.

Configuration requise

Condition requise	Valeur
Plateforme cible	Windows
En-tête	d3d11.h
Bibliothèque	D3D11.lib

Voir aussi

ID3D11Device