ID3D10Device::CreateInputLayout-Methode (d3d10.h)

Erstellen Sie ein Eingabelayoutobjekt, um die Eingabepufferdaten für die Input-Assembler-Phase zu beschreiben.

Syntax

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

Parameter

[in] pInputElementDescs

Typ: const D3D10_INPUT_ELEMENT_DESC*

Ein Array der Eingabedatentypen der Eingabe-Assembler-Phase; jeder Typ wird durch eine Elementbeschreibung beschrieben (siehe D3D10_INPUT_ELEMENT_DESC).

[in] NumElements

Typ: UINT

Die Anzahl der Eingabedatentypen im Array der Eingabeelemente.

[in] pShaderBytecodeWithInputSignature

Typ: const void*

Ein Zeiger auf den kompilierten Shader. Informationen zum Abrufen dieses Zeigers finden Sie unter Abrufen eines Zeigers auf einen kompilierten Shader. Der kompilierte Shadercode enthält eine Eingabesignatur , die anhand des Arrays von Elementen überprüft wird. Siehe Bemerkungen.

[in] BytecodeLength

Typ: SIZE_T

Größe des kompilierten Shaders.

[out] ppInputLayout

Typ: ID3D10InputLayout**

Ein Zeiger auf das erstellte Eingabelayoutobjekt (siehe ID3D10InputLayout-Schnittstelle). Um die anderen Eingabeparameter zu überprüfen, legen Sie diesen Zeiger auf NULL fest, und überprüfen Sie, ob die Methode S_FALSE zurückgibt.

Rückgabewert

Typ: HRESULT

Wenn die Methode erfolgreich ist, wird der Rückgabecode S_OK. Fehlercodes finden Sie unter Direct3D 10-Rückgabecodes .

Hinweise

Nach dem Erstellen eines Eingabelayoutobjekts muss es an die Eingabe-Assembler-Phase gebunden werden, bevor eine Zeichnungs-API aufgerufen wird. Beispielcode finden Sie unter Erste Schritte mit der Input-Assembler Stage (Direct3D 10).

Sobald ein Eingabelayoutobjekt aus einer Shadersignatur erstellt wurde, kann das Eingabelayoutobjekt mit jedem anderen Shader wiederverwendet werden, der eine identische Eingabesignatur aufweist (Semantik enthalten). Dies kann die Erstellung von Eingabelayoutobjekten vereinfachen, wenn Sie mit vielen Shadern mit identischen Eingaben arbeiten.

Wenn ein Datentyp in der Eingabelayoutdeklaration nicht mit dem Datentyp in einer Shadereingabesignatur übereinstimmt, generiert CreateInputLayout während der Kompilierung eine Warnung. Die Warnung besteht darin, einfach darauf aufmerksam zu machen, dass die Daten beim Lesen aus einem Register möglicherweise neu interpretiert werden. Sie können diese Warnung entweder ignorieren (wenn die Neuinterpretation beabsichtigt ist) oder die Übereinstimmung der Datentypen in beiden Deklarationen sicherstellen, um die Warnung zu beseitigen. In der Übersicht über Die Datenkonvertierungsregeln werden die Regeln beschrieben, die für die Datentypkonvertierung angewendet werden.

Anforderungen

Weitere Informationen

ID3D10Geräteschnittstelle