struttura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA (d3dkmddi.h)

Articolo
11/11/2024

La struttura DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA descrive un tipo di allocazione standard.

Sintassi

typedef struct _DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA {
  D3DKMDT_STANDARDALLOCATION_TYPE StandardAllocationType;
  union {
    D3DKMDT_SHAREDPRIMARYSURFACEDATA *pCreateSharedPrimarySurfaceData;
    D3DKMDT_SHADOWSURFACEDATA        *pCreateShadowSurfaceData;
    D3DKMDT_STAGINGSURFACEDATA       *pCreateStagingSurfaceData;
    D3DKMDT_GDISURFACEDATA           *pCreateGdiSurfaceData;
    D3DKMDT_VIRTUALGPUSURFACEDATA    *pCreateVirtualGpuSurfaceData;
    D3DKMDT_FENCESTORAGESURFACEDATA  *pCreateFenceStorageData;
  };
  VOID                            *pAllocationPrivateDriverData;
  UINT                            AllocationPrivateDriverDataSize;
  VOID                            *pResourcePrivateDriverData;
  UINT                            ResourcePrivateDriverDataSize;
  UINT                            PhysicalAdapterIndex;
} DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA;

Membri

StandardAllocationType

[in] Valore D3DKMDT_STANDARDALLOCATION_TYPEtipizzato che identifica il tipo di allocazione standard da descrivere.

pCreateSharedPrimarySurfaceData

[in] Puntatore a una struttura D3DKMDT_SHAREDPRIMARYSURFACEDATA, se StandardAllocationType specifica D3DKMDT_STANDARDALLOCATION_SHAREDPRIMARYSURFACE.

pCreateShadowSurfaceData

[in] Puntatore a una struttura D3DKMDT_SHADOWSURFACEDATA, se StandardAllocationType specifica D3DKMDT_STANDARDALLOCATION_SHADOWSURFACE.

pCreateStagingSurfaceData

[in] Puntatore a una struttura D3DKMDT_STAGINGSURFACEDATA, se StandardAllocationType specifica D3DKMDT_STANDARDALLOCATION_STAGINGSURFACE.

pCreateGdiSurfaceData

[in] Puntatore a una struttura di D3DKMDT_GDISURFACEDATA, disponibile solo se StandardAllocationType specifica D3DKMDT_STANDARDALLOCATION_GDISURFACE.

Questo membro è disponibile a partire da Windows 7.

pCreateVirtualGpuSurfaceData

Puntatore a una struttura D3DKMDT_VIRTUALGPUSURFACEDATA se StandardAllocationType è D3DKMDT_STANDARDALLOCATION_VIRTUALGPUSURFACE. Disponibile a partire da WDDM 2.1.

pCreateFenceStorageData

Puntatore a una struttura di D3DKMDT_FENCESTORAGESURFACEDATA se StandardAllocationType è D3DKMDT_STANDARDALLOCATION_FENCESTORAGE. Disponibile a partire da WDDM 3.2.

pAllocationPrivateDriverData

[in/out] Puntatore a un blocco di dati privati di allocazione che descrive il tipo di allocazione standard; in caso contrario, questo membro è NULL. I dati privati di allocazione restituiti dalla funzione dxgkDdiGetStandardAllocationDriverData del driver di visualizzazione dipendono dal tipo richiesto dal driver in StandardAllocationType.

AllocationPrivateDriverDataSize

[out] Dimensioni, in byte, dei dati privati di allocazione a cui pAllocationPrivateDriverData punti. Se il driver imposta pAllocationPrivateDriverData su NULL, il driver deve impostare AllocationPrivateDriverDataSize sulle dimensioni del buffer richiesto dal driver per descrivere il tipo di allocazione standard specificato.

Se il driver non usa dati privati per ogni allocazione per i tipi di allocazioni standard, il driver può impostare AllocationPrivateDriverDataSize su zero.

pResourcePrivateDriverData

[in/out] Puntatore a un blocco di dati privati della risorsa che descrive il tipo di allocazione standard; in caso contrario, questo membro è NULL. I dati privati della risorsa restituiti dalla funzione del driver miniport DxgkDdiGetStandardAllocationDriverData dipendono dal tipo richiesto dal driver in StandardAllocationType.

ResourcePrivateDriverDataSize

[out] Dimensioni, in byte, dei dati privati della risorsa a cui pResourcePrivateDriverData punta. Se il driver imposta pResourcePrivateDriverData su NULL, il driver deve impostare ResourcePrivateDriverDataSize alle dimensioni del buffer richiesto dal driver per descrivere il tipo di allocazione standard specificato.

Se il driver non usa dati privati per ogni risorsa per i tipi di allocazioni standard, il driver può impostare ResourcePrivateDriverDataSize su zero.

PhysicalAdapterIndex

[in] Indice dell'adattatore fisico in una configurazione LDA in cui risiederà l'archiviazione.

Osservazioni

tipi di allocazione Standard sono allocazioni che devono essere create in modalità kernel senza comunicazione dal driver di visualizzazione in modalità utente.

Se il driver miniport (KMD) in modalità kernel restituisce NULL nel pAllocationPrivateDriverData e membro pResourcePrivateDriverData, deve restituire le dimensioni dei buffer richiesti nei membri AllocationPrivateDriverDataSize e ResourcePrivateDriverDataSize. Tuttavia, il kmD non deve modificare il contenuto della struttura di allocazione standard nell'unione che DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA contiene per ottenere le dimensioni necessarie dei buffer.

Anche se kmd può impostare ResourcePrivateDriverDataSize o AllocationPrivateDriverDataSize su zero, non può impostare entrambi su zero.