Método ID3D10Device::CreateTexture2D (d3d10.h)

Cree una matriz de texturas 2D (consulte Texture2D).

Sintaxis

HRESULT CreateTexture2D(
  [in]  const D3D10_TEXTURE2D_DESC   *pDesc,
  [in]  const D3D10_SUBRESOURCE_DATA *pInitialData,
  [out] ID3D10Texture2D              **ppTexture2D
);

Parámetros

[in] pDesc

Tipo: const D3D10_TEXTURE2D_DESC*

Puntero a una descripción de textura 2D (consulte D3D10_TEXTURE2D_DESC). Para crear un recurso sin tipo que se pueda interpretar en tiempo de ejecución en diferentes formatos compatibles, especifique un formato sin tipo en la descripción de la textura. Para generar niveles de mapa mip automáticamente, establezca el número de niveles de mapa mip en 0.

[in] pInitialData

Tipo: const D3D10_SUBRESOURCE_DATA*

Puntero a una matriz de descripciones de subrecursos (vea D3D10_SUBRESOURCE_DATA); uno para cada subrecurso (ordenado por índice de matriz de texturas y, a continuación, nivel mip). Es posible que las aplicaciones no especifiquen NULL para pInitialData al crear recursos INMUTABLEs (consulte D3D10_USAGE). Si el recurso es multimuestreo, pInitialData debe ser NULL porque los recursos de muestreo múltiple no se pueden inicializar con datos cuando se crean.

[out] ppTexture2D

Tipo: ID3D10Texture2D**

Dirección de un puntero a la textura creada (vea ID3D10Texture2D Interface). Establezca este parámetro en NULL para validar los demás parámetros de entrada (el método devolverá S_FALSE si los demás parámetros de entrada pasan la validación).

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 10 para ver los códigos de error con errores.

Comentarios

CreateTexture2D crea un recurso de textura 2D, que contiene una matriz de texturas 1D. El número de texturas se especifica en la descripción de la textura. Todas las texturas de un recurso deben tener el mismo formato, tamaño y número de niveles de mapa mip.

Todos los recursos se componen de uno o varios subrecursos. Para cargar datos en la textura, las aplicaciones pueden proporcionar inicialmente los datos como parte de D3D10_SUBRESOURCE_DATA estructura a la que apunta pInitialData, o bien puede usar una de las funciones de texturización proporcionadas por el SDK.

Requisitos

Requisito	Value
Plataforma de destino	Windows
Encabezado	d3d10.h
Library	D3D10.lib

Consulte también

Id3D10Device (interfaz)