struttura D3D11DDIARG_CREATERESOURCE (d3d10umddi.h)

Articolo
02/06/2025

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;

Membri

[in] pMipInfoList

Matrice di strutture D3D10DDI_MIPINFO che contiene dimensioni per i livelli MIP. Per i formati di risorsa 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 del texel, per soddisfare i requisiti di spazio necessari. Ad esempio, per creare un 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, 1, 4, 1 } }.

[in] pInitialDataUP

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

[in] ResourceDimension

Valore di tipo D3D10DDIRESOURCE_TYPE che indica il tipo di risorsa e la dimensionalità.

[in] Usage

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

[in] BindFlags

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

[in] MapFlags

Valore di tipo D3D10_DDI_MAP che indica il livello di accesso da mappare 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 di 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 nascosto 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 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 primaria (ovvero la risorsa viene analizzata fino alla visualizzazione) e nelle operazioni di presentazione in stile capovolto.

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

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

[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 utilizzato dal decodificatore video.

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

TextureLayout