DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA struttura (d3dkmddi.h)

Articolo
05/23/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;

Members

StandardAllocationType

[in] Valore D3DKMDT_STANDARDALLOCATION_TYPE tipizzato 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 di D3DKMDT_STAGINGSURFACEDATA , se StandardAllocationType specifica D3DKMDT_STANDARDALLOCATION_STAGINGSURFACE.

pCreateGdiSurfaceData

[in] Puntatore a una struttura 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

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 visualizzano il tipo richiesto dal driver in StandardAllocationType.

AllocationPrivateDriverDataSize

[out] Dimensioni, in byte, dei dati privati di allocazione a cui pAllocationPrivateDriverData punta. 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 delle risorse che descrive il tipo di allocazione standard; in caso contrario, questo membro è NULL. I dati privati della risorsa restituiti dalla funzione DxgkDdiGetStandardAllocationDriverData visualizzano il 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 sulle 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

Commenti

Se il driver miniport visualizzato restituisce NULL nei membri pAllocationPrivateDriverData e pResourcePrivateDriverData , il driver deve restituire le dimensioni dei buffer richiesti dal driver nei membri AllocationPrivateDriverDataSize e ResourcePrivateDriverDataSize . Tuttavia, il driver 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 il driver può impostare ResourcePrivateDriverDataSize o AllocationPrivateDriverDataSize su zero, il driver non può impostare entrambi su zero.