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

Crie uma matriz de texturas 2D (consulte Texture2D).

Sintaxe

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*

Ponteiro para uma descrição de textura 2D (consulte D3D10_TEXTURE2D_DESC). Para criar um recurso sem tipo que pode ser interpretado em runtime em formatos diferentes e compatíveis, especifique um formato sem tipo na descrição da textura. Para gerar níveis de mipmap automaticamente, defina o número de níveis de mipmap como 0.

[in] pInitialData

Tipo: const D3D10_SUBRESOURCE_DATA*

Ponteiro para uma matriz de descrições de sub-recursos (consulte D3D10_SUBRESOURCE_DATA); um para cada sub-recurso (ordenado pelo índice de matriz de textura e, em seguida, o nível de mip). Os aplicativos podem não especificar NULL para pInitialData ao criar recursos IMMUTABLE (consulte D3D10_USAGE). Se o recurso for multisampled, pInitialData deverá ser NULL porque recursos multisampled não podem ser inicializados com dados quando são criados.

[out] ppTexture2D

Tipo: ID3D10Texture2D**

Endereço de um ponteiro para a textura criada (consulte Interface ID3D10Texture2D). Defina esse parâmetro como NULL para validar os outros parâmetros de entrada (o método retornará S_FALSE se os outros parâmetros de entrada passarem pela validação).

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, o código de retorno será S_OK. Consulte Códigos de retorno do Direct3D 10 para obter códigos de erro com falha.

Comentários

CreateTexture2D cria um recurso de textura 2D, que contém uma matriz de texturas 1D. O número de texturas é especificado na descrição da textura. Todas as texturas em um recurso devem ter o mesmo formato, tamanho e número de níveis de mipmap.

Todos os recursos são compostos por um ou mais sub-recursos. Para carregar dados na textura, os aplicativos podem fornecer os dados inicialmente como parte de D3D10_SUBRESOURCE_DATA estrutura apontada por pInitialData ou pode usar uma das Funções de Texturing fornecidas pelo SDK.

Requisitos

Requisito	Valor
Plataforma de Destino	Windows
Cabeçalho	d3d10.h
Biblioteca	D3D10.lib

Confira também

ID3D10Device Interface