Metodo ID3D10Device::CreateTexture1D (d3d10.h)

Creare una matrice di trame 1D (vedere Texture1D).

Sintassi

HRESULT CreateTexture1D(
  [in]  const D3D10_TEXTURE1D_DESC   *pDesc,
  [in]  const D3D10_SUBRESOURCE_DATA *pInitialData,
  [out] ID3D10Texture1D              **ppTexture1D
);

Parametri

[in] pDesc

Tipo: const D3D10_TEXTURE1D_DESC*

Puntatore a una descrizione della trama 1D (vedere D3D10_TEXTURE1D_DESC). 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] pInitialData

Tipo: const D3D10_SUBRESOURCE_DATA*

Puntatore a una matrice di descrizioni di sottoresource (vedere D3D10_SUBRESOURCE_DATA); uno per ogni sottoresource (ordinato in base all'indice della matrice di trama). 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 multicampionate non possono essere inizializzate con i dati quando vengono creati.

[out] ppTexture1D

Tipo: ID3D10Texture1D**

Indirizzo di un puntatore alla trama creata (vedere ID3D10Texture1D Interface). 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 10 .

Commenti

CreateTexture1D crea una risorsa trama 1D 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 di mipmap.

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

Requisiti

Vedi anche

Interfaccia ID3D10Device