D3D10DDIARG_CREATERESOURCE struttura (d3d10umddi.h)

Articolo
02/25/2024

D3D10DDIARG_CREATERESOURCE contiene gli argomenti usati da PFND3D10DDI_CREATERESOURCE per creare una risorsa.

Sintassi

typedef struct D3D10DDIARG_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;
} D3D10DDIARG_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 di valori 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 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 questo membro 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 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 nelle operazioni presenti in stile copia (trasferimento a blocchi bit).