Share via

Metodo ID3D10Device::CreateTexture3D (d3d10.h)

  • Articolo

Creare una singola trama 3D (vedere Texture3D).

Sintassi

HRESULT CreateTexture3D(
  [in]  const D3D10_TEXTURE3D_DESC   *pDesc,
  [in]  const D3D10_SUBRESOURCE_DATA *pInitialData,
  [out] ID3D10Texture3D              **ppTexture3D
);

Parametri

[in] pDesc

Tipo: const D3D10_TEXTURE3D_DESC*

Puntatore a una descrizione della trama 3D (vedere D3D10_TEXTURE3D_DESC). Per creare una risorsa senza tipi che può essere interpretata in fase di esecuzione in formati compatibili diversi, specificare un formato senza tipi nella descrizione della trama. Per generare automaticamente livelli mipmap, impostare il numero di livelli mipmap su 0.

[in] pInitialData

Tipo: const D3D10_SUBRESOURCE_DATA*

Puntatore a una matrice di descrizioni di sottorisorse (vedere D3D10_SUBRESOURCE_DATA); uno per ogni sottorisorsa (ordinata in base all'indice della matrice di trame, quindi a livello mip). Le applicazioni potrebbero non specificare NULL per pInitialData durante la creazione di risorse IMMUTABLE (vedere D3D10_USAGE). Se la risorsa è multicampionata, pInitialData deve essere NULL perché le risorse multicampionamento non possono essere inizializzate con i dati al momento della creazione.

[out] ppTexture3D

Tipo: ID3D10Texture3D**

Indirizzo di un puntatore alla trama creata (vedere l'interfaccia ID3D10Texture3D). Impostare questo parametro su NULL per convalidare gli altri parametri di input. Il metodo restituirà S_FALSE se gli altri parametri di input superano la convalida.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il codice restituito viene S_OK. Vedere Codici restituiti Direct3D 10 per i codici di errore non riusciti.

Commenti

CreateTexture3D crea una risorsa trama 3D, che contiene una matrice di trame 1D. 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 mipmap.

Tutte le risorse sono costituite da una o più sottorisorse. Per caricare i dati nella trama, le applicazioni possono fornire inizialmente i dati come parte di D3D10_SUBRESOURCE_DATA struttura a cui punta pInitialData oppure può usare una delle funzioni di texturing fornite dall'SDK.

Requisiti

   
Piattaforma di destinazione Windows
Intestazione d3d10.h
Libreria D3D10.lib

Vedi anche

Interfaccia ID3D10Device