Metodo ID3D11Device::CreateTexture2D (d3d11.h)

Creare una matrice di trame 2D.

Sintassi

HRESULT CreateTexture2D(
  [in]            const D3D11_TEXTURE2D_DESC   *pDesc,
  [in, optional]  const D3D11_SUBRESOURCE_DATA *pInitialData,
  [out, optional] ID3D11Texture2D              **ppTexture2D
);

Parametri

[in] pDesc

Tipo: const D3D11_TEXTURE2D_DESC*

Puntatore a una struttura D3D11_TEXTURE2D_DESC che descrive una risorsa trama 2D. Per creare una risorsa senza tipi che può essere interpretata in fase di esecuzione in formati diversi e compatibili, specificare un formato senza tipi nella descrizione della trama. Per generare automaticamente livelli di mipmap, impostare il numero di livelli mipmap su 0.

[in, optional] pInitialData

Tipo: const D3D11_SUBRESOURCE_DATA*

Puntatore a una matrice di strutture D3D11_SUBRESOURCE_DATA che descrivono le sottoresource per la risorsa trama 2D. Le applicazioni non possono specificare NULL per pInitialData durante la creazione di risorse IMMUTABLE (vedere D3D11_USAGE). Se la risorsa è multicampionata, pInitialData deve essere NULL perché le risorse multicampionate non possono essere inizializzate con i dati quando vengono creati.

Se non si passa nulla a pInitialData, il contenuto iniziale della memoria per la risorsa non è definito. In questo caso, è necessario scrivere il contenuto della risorsa in un altro modo prima di leggere la risorsa.

È possibile determinare le dimensioni di questa matrice dai valori nei membri MipLevels e ArraySize della struttura D3D11_TEXTURE2D_DESC a cui pDesc punta usando il calcolo seguente:

MipLevels * ArraySize

Per altre informazioni su questa dimensione della matrice, vedere Osservazioni.

[out, optional] ppTexture2D

Tipo: ID3D11Texture2D**

Puntatore a un buffer che riceve un puntatore a un'interfaccia ID3D11Texture2D per la trama creata. Impostare questo parametro su NULL per convalidare gli altri parametri di input (il metodo restituirà S_FALSE se gli altri parametri di input passano la convalida).

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il codice restituito è S_OK. Per errori, vedere Codici restituiti Direct3D 11 .

Commenti

CreateTexture2D crea una risorsa trama 2D, che può contenere un numero di sottoresource 2D. Il numero di trame viene specificato nella descrizione della trama. Tutte le trame in una risorsa devono avere lo stesso formato, dimensioni e numero di livelli di mipmap.

Tutte le risorse sono costituite da una o più sottoresource. Per caricare i dati nella trama, le applicazioni possono fornire inizialmente i dati come matrice di strutture D3D11_SUBRESOURCE_DATA puntate da pInitialData oppure possono usare una delle funzioni di trama D3DX, ad esempio D3DX11CreateTextureFromFile.

Per una trama di 32 x 32 con una catena di mipmap completa, la matrice pInitialData ha i seguenti 6 elementi:

• pInitialData[0] = 32x32
• pInitialData[1] = 16x16
• pInitialData[2] = 8x8
• pInitialData[3] = 4x4
• pInitialData[4] = 2x2
• pInitialData[5] = 1x1

Requisiti

Vedi anche

ID3D11Device