struttura D3D11_TEXTURE2D_DESC (d3d11.h)

Descrive una trama 2D.

Sintassi

typedef struct D3D11_TEXTURE2D_DESC {
  UINT             Width;
  UINT             Height;
  UINT             MipLevels;
  UINT             ArraySize;
  DXGI_FORMAT      Format;
  DXGI_SAMPLE_DESC SampleDesc;
  D3D11_USAGE      Usage;
  UINT             BindFlags;
  UINT             CPUAccessFlags;
  UINT             MiscFlags;
} D3D11_TEXTURE2D_DESC;

Members

Width

Tipo: UINT

Larghezza trama (in texel). L'intervallo è compreso tra 1 e D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). Per una mappa del cubo di trama, l'intervallo è compreso tra 1 e D3D11_REQ_TEXTURECUBE_DIMENSION (16384). Tuttavia, l'intervallo è effettivamente vincolato dal livello di funzionalità a cui si crea il dispositivo di rendering. Per altre informazioni sulle restrizioni, vedere Osservazioni.

Height

Tipo: UINT

Altezza trama (in texel). L'intervallo è compreso tra 1 e D3D11_REQ_TEXTURE2D_U_OR_V_DIMENSION (16384). Per una mappa del cubo di trama, l'intervallo è compreso tra 1 e D3D11_REQ_TEXTURECUBE_DIMENSION (16384). Tuttavia, l'intervallo è effettivamente vincolato dal livello di funzionalità a cui si crea il dispositivo di rendering. Per altre informazioni sulle restrizioni, vedere Osservazioni.

MipLevels

Tipo: UINT

Numero massimo di livelli di mipmap nella trama. Vedere le osservazioni in D3D11_TEX1D_SRV. Usare 1 per una trama multicampionata; o 0 per generare un set completo di sottotexture.

ArraySize

Tipo: UINT

Numero di trame nella matrice di trama. L'intervallo è compreso tra 1 e D3D11_REQ_TEXTURE2D_ARRAY_AXIS_DIMENSION (2048). Per una mappa del cubo di trama, questo valore è un multiplo di 6 (ovvero 6 volte il valore nel membro NumCubes di D3D11_TEXCUBE_ARRAY_SRV) e l'intervallo è compreso tra 6 e 2046. L'intervallo è effettivamente vincolato dal livello di funzionalità a cui si crea il dispositivo di rendering. Per altre informazioni sulle restrizioni, vedere Osservazioni.

Format

Tipo: DXGI_FORMAT

Formato trama (vedere DXGI_FORMAT).

SampleDesc

Tipo: DXGI_SAMPLE_DESC

Struttura che specifica parametri multicampionamento per la trama. Vedere DXGI_SAMPLE_DESC.

Usage

Tipo: D3D11_USAGE

Valore che identifica la modalità di lettura e scrittura della trama. Il valore più comune è D3D11_USAGE_DEFAULT; vedere D3D11_USAGE per tutti i valori possibili.

BindFlags

Tipo: UINT

Flag (vedere D3D11_BIND_FLAG) per l'associazione alle fasi della pipeline. I flag possono essere combinati da un OR bit per bit.

CPUAccessFlags

Tipo: UINT

Flag (vedere D3D11_CPU_ACCESS_FLAG) per specificare i tipi di accesso alla CPU consentiti. Usare 0 se l'accesso alla CPU non è obbligatorio. Questi flag possono essere combinati con un OR bit per bit.

MiscFlags

Tipo: UINT

Flag (vedere D3D11_RESOURCE_MISC_FLAG) che identificano altre opzioni di risorsa meno comuni. Usare 0 se non si applicano nessuno di questi flag. Questi flag possono essere combinati usando un OR bit per bit. Per una mappa del cubo di trama, impostare il flag di D3D11_RESOURCE_MISC_TEXTURECUBE . Le matrici mappa cubo ,ovvero ArraySize> 6, richiedono D3D_FEATURE_LEVEL_10_1 o versioni successive.

Commenti

Questa struttura viene usata in una chiamata a ID3D11Device::CreateTexture2D.

Oltre a questa struttura, è anche possibile usare la struttura derivata CD3D11_TEXTURE2D_DESC , definita in D3D11.h e si comporta come una classe ereditata, per creare una descrizione della trama.

Il dispositivo inserisce alcune restrizioni di dimensioni (deve essere più di una dimensione minima) per una risorsa sottocampionata, compressa o in formato bit.

L'intervallo di dimensioni della trama è determinato dal livello di funzionalità in cui si crea il dispositivo e non dalla versione dell'interfaccia Microsoft Direct3D. Ad esempio, se si usa l'hardware Microsoft Direct3D 10 a livello di funzionalità 10 (D3D_FEATURE_LEVEL_10_0) e chiamare D3D11CreateDevice per creare un ID3D11Device, è necessario limitare le dimensioni massime della trama a D3D10_REQ_TEXTURE2D_U_OR_V_DIMENSION (8192) quando si crea la trama 2D.

Requisiti

Requisito	Valore
Intestazione	d3d11.h

Vedi anche

Strutture delle risorse