Metodo ID3D11Device3::CreateTexture2D1 (d3d11_3.h)

Articolo
03/13/2024

Sintassi

HRESULT CreateTexture2D1(
  [in]            const D3D11_TEXTURE2D_DESC1  *pDesc1,
  [in, optional]  const D3D11_SUBRESOURCE_DATA *pInitialData,
  [out, optional] ID3D11Texture2D1             **ppTexture2D
);

Parametri

[in] pDesc1

Tipo: const D3D11_TEXTURE2D_DESC1*

Puntatore a una struttura D3D11_TEXTURE2D_DESC1 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_DESC1 a cui pDesc1 punti usando il calcolo seguente:

MipLevels * ArraySize

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

[out, optional] ppTexture2D

Tipo: ID3D11Texture2D1**

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

CreateTexture2D1 crea una risorsa trama 2D, che può contenere un numero di sottoresource 2D. Il numero di sottoresource 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

Requisito	Valore
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