Método ID3D11Device::CreateInputLayout (d3d11.h)

Cree un objeto de diseño de entrada para describir los datos del búfer de entrada para la fase del ensamblador de entrada.

Sintaxis

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

Parámetros

[in] pInputElementDescs

Tipo: const D3D11_INPUT_ELEMENT_DESC*

Matriz de los tipos de datos de entrada de la fase de ensamblador de entrada; cada tipo se describe mediante una descripción del elemento (vea D3D11_INPUT_ELEMENT_DESC).

[in] NumElements

Tipo: UINT

Número de tipos de datos de entrada en la matriz de elementos de entrada.

[in] pShaderBytecodeWithInputSignature

Tipo: const void*

Puntero al sombreador compilado. El código del sombreador compilado contiene una firma de entrada que se valida con la matriz de elementos. Vea Notas.

[in] BytecodeLength

Tipo: SIZE_T

Tamaño del sombreador compilado.

[out, optional] ppInputLayout

Tipo: ID3D11InputLayout**

Puntero al objeto de diseño de entrada creado (vea ID3D11InputLayout). Para validar los demás parámetros de entrada, establezca este puntero en NULL y compruebe que el método devuelve S_FALSE.

Valor devuelto

Tipo: HRESULT

Si el método se realiza correctamente, el código devuelto se S_OK. Consulta Códigos de retorno de Direct3D 11 para ver los códigos de error con errores.

Comentarios

Después de crear un objeto de diseño de entrada, debe enlazarse a la fase del ensamblador de entrada antes de llamar a una API draw.

Una vez creado un objeto de diseño de entrada a partir de una firma de sombreador, el objeto de diseño de entrada se puede reutilizar con cualquier otro sombreador que tenga una firma de entrada idéntica (semántica incluida). Esto puede simplificar la creación de objetos de diseño de entrada cuando se trabaja con muchos sombreadores con entradas idénticas.

Si un tipo de datos de la declaración de diseño de entrada no coincide con el tipo de datos de una firma de entrada de sombreador, CreateInputLayout generará una advertencia durante la compilación. La advertencia es simplemente llamar la atención sobre el hecho de que los datos se pueden reinterpretar cuando se leen desde un registro. Puede omitir esta advertencia (si la reinterpretación es intencionada) o hacer que los tipos de datos coincidan en ambas declaraciones para eliminar la advertencia.

Windows Phone 8: se admite esta API.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	d3d11.h
Library	D3D11.lib

Consulte también

ID3D11Device