Metodo ID3D11Device3::CreateTexture3D1 (d3d11_3.h)

Articolo
08/22/2023

Sintassi

HRESULT CreateTexture3D1(
  [in]            const D3D11_TEXTURE3D_DESC1  *pDesc1,
  [in, optional]  const D3D11_SUBRESOURCE_DATA *pInitialData,
  [out, optional] ID3D11Texture3D1             **ppTexture3D
);

Parametri

[in] pDesc1

Tipo: const D3D11_TEXTURE3D_DESC1*

Puntatore a una struttura D3D11_TEXTURE3D_DESC1 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_DESC1 a cui pDesc1 punti. Le matrici di trame del volume 3D non sono supportate.

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

[out, optional] ppTexture3D

Tipo: ID3D11Texture3D1**

Puntatore a un blocco di memoria che riceve un puntatore a un'interfaccia ID3D11Texture3D1 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

CreateTexture3D1 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


Client minimo supportato	Windows 10 [solo app desktop]
Server minimo supportato	Windows Server 2016 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	d3d11_3.h
Libreria	D3D11.lib

Vedi anche

ID3D11Device3

Condividi tramite