struttura D3D10DDIARG_CREATERESOURCE (d3d10umddi.h)

Articolo
02/06/2025

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;

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 D3D10_DDI_RESOURCE_BIND_FLAG che indica il modo in cui la risorsa è associata.

[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 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 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 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 flip.

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