D3D11DDIARG_CREATERESOURCE struttura (d3d10umddi.h)

Articolo
02/22/2024

La struttura D3D11DDIARG_CREATERESOURCE descrive una risorsa da creare.

Sintassi

typedef struct D3D11DDIARG_CREATERESOURCE {
  [in]      const D3D10DDI_MIPINFO               *pMipInfoList;
  [in]      const D3D10_DDIARG_SUBRESOURCE_UP    *pInitialDataUP;
  [in]      D3D10DDIRESOURCE_TYPE                ResourceDimension;
  [in]      UINT                                 Usage;
  [in]      UINT                                 BindFlags;
  [in]      UINT                                 MapFlags;
  [in]      UINT                                 MiscFlags;
  [in]      DXGI_FORMAT                          Format;
  [in]      DXGI_SAMPLE_DESC                     SampleDesc;
  [in]      UINT                                 MipLevels;
  [in]      UINT                                 ArraySize;
  [in, out] DXGI_DDI_PRIMARY_DESC                *pPrimaryDesc;
  [in]      UINT                                 ByteStride;
  [in]      D3D11_1DDI_VIDEO_DECODER_BUFFER_TYPE DecoderBufferType;
            D3DWDDM2_0DDI_TEXTURE_LAYOUT         TextureLayout;
} D3D11DDIARG_CREATERESOURCE;

Members

[in] pMipInfoList

Matrice di strutture D3D10DDI_MIPINFO che contiene dimensioni per i livelli MIP. Per i formati di risorse in cui non è possibile fare riferimento direttamente a un singolo pixel o texel con un indirizzo di byte, le dimensioni della risorsa fisica sono in genere maggiori o uguali alle dimensioni texel, per soddisfare i requisiti di spazio necessari. Ad esempio, per creare un oggetto BC1 Texture2D completamente ignorato, dove il livello più dettagliato è 8x8, la matrice pMipInfoList è: { { { 8, 8, 1, 8, 8, 1 }, { 4, 4, 1, 4, 4, 1 }, { 2, 2, 1, 4, 4, 1 }, { 1, 1, 4, 1 } .

[in] pInitialDataUP

Matrice di strutture D3D10_DDIARG_SUBRESOURCE_UP che fornisce informazioni di inizializzazione per l'elenco delle sottoresource della risorsa.

[in] ResourceDimension

Valore di tipo D3D10DDIRESOURCE_TYPE che indica il tipo di risorsa e la dimensione.

[in] Usage

Valore di tipo D3D10_DDI_RESOURCE_USAGE che indica come viene usata la risorsa.

[in] BindFlags

Or bit per bit valido dei valori di tipo D3D10_DDI_RESOURCE_BIND_FLAG che indica come è associata la risorsa.

[in] MapFlags

Valore di tipo D3D10_DDI_MAP che indica il livello di accesso per eseguire il mapping alla risorsa.

[in] MiscFlags

Or bit per bit valido di valori di tipo D3D10_DDI_RESOURCE_MISC_FLAG che indica informazioni varie sulla risorsa.

[in] Format

Valore di tipo DXGI_FORMAT che indica il formato pixel della risorsa.

[in] SampleDesc

Valore di tipo DXGI_SAMPLE_DESC che descrive il numero di campioni e la qualità della risorsa.

[in] MipLevels

Numero di livelli di mappa MIP per la risorsa.

[in] ArraySize

Numero di elementi della matrice per una trama 2D o una trama 1D. ArraySize deve essere impostato su 6 per una trama del cubo.

A partire da Windows 8, se il driver deve creare un buffer back stereo, deve impostare il membro ArraySize della struttura D3D11DDIARG_CREATERESOURCE su un valore pari a 2.

[in, pPrimaryDesc

Puntatore a una struttura DXGI_DDI_PRIMARY_DESC che descrive una risorsa usata come primaria.

Il runtime di Microsoft Direct3D imposta pPrimaryDesc su un valore non NULL solo se il bit di D3D10_DDI_BIND_PRESENT è impostato nel membro BindFlags ; tuttavia, anche se D3D10_DDI_BIND_PRESENT è impostato, il runtime non imposta sempre pPrimaryDesc su non NULL. L'impostazione di pPrimaryDesc su non NULL indica che il runtime userà la risorsa creata come risorsa primaria , ovvero la risorsa viene analizzata nella visualizzazione e in operazioni presenti in stile flip.

Il driver di visualizzazione in modalità utente può restituire il flag di DXGI_DDI_PRIMARY_DRIVER_FLAG_NO_SCANOUT nel membro DriverFlags di DXGI_DDI_PRIMARY_DESC per impedire al runtime di eseguire operazioni presenti in stile flip.

Se pPrimaryDesc è impostato su NULL, il runtime userà la risorsa creata in; operazioni presenti in stile copia (trasferimento a blocchi bit).

[in] ByteStride

Dimensioni, in byte, da una riga di analisi alla riga di analisi successiva nella superficie.

[in] DecoderBufferType

Valore di tipo D3D11_DDI_VIDEO_DECODER_BUFFER_TYPE che indica il tipo di buffer usato dal decodificatore video.

Se il driver non controlla che D3D11DDI_MINOR_HEADER_VERSION = 3 prima di accedere a questo membro della struttura, deve accedere a questo membro solo quando il flag di D3D11_DDI_BIND_DECODER >è impostato nel membro BindFlags .

TextureLayout