Metodo ID3D11Device::CreateTexture3D (d3d11.h)
Creare una trama 3D singola.
Sintassi
HRESULT CreateTexture3D(
[in] const D3D11_TEXTURE3D_DESC *pDesc,
[in, optional] const D3D11_SUBRESOURCE_DATA *pInitialData,
[out, optional] ID3D11Texture3D **ppTexture3D
);
Parametri
[in] pDesc
Tipo: const D3D11_TEXTURE3D_DESC*
Puntatore a una struttura D3D11_TEXTURE3D_DESC che descrive una risorsa trama 3D. 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 3D. 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 dal valore del membro MipLevels della struttura D3D11_TEXTURE3D_DESC a cui punta pDesc . Le matrici di trame del volume 3D non sono supportate.
Per altre informazioni su questa dimensione della matrice, vedere Osservazioni.
[out, optional] ppTexture3D
Tipo: ID3D11Texture3D**
Puntatore a un buffer che riceve un puntatore a un'interfaccia ID3D11Texture3D 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
CreateTexture3D crea una risorsa trama 3D, che può contenere un numero di sottoresource 3D. 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.
Ogni elemento di pInitialData fornisce tutte le sezioni definite per un determinato miplevel. Ad esempio, per una trama di volume 32 x 32 x 4 con una catena di mipmap completa, la matrice ha i seguenti 6 elementi:
- pInitialData[0] = 32x32 con 4 sezioni
- pInitialData[1] = 16x16 con 2 sezioni
- pInitialData[2] = 8x8 con 1 sezione
- pInitialData[3] = 4x4 con 1 sezione
- pInitialData[4] = 2x2 con 1 sezione
- pInitialData[5] = 1x1 con 1 sezione
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | d3d11.h |
| Libreria | D3D11.lib |