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

Confira também

ID3D10Device Interface