DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 結構 (d3dkmddi.h)

發行項
05/23/2024

DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA結構描述標準配置類型。

語法

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;

成員

StandardAllocationType

[in]識別要描述之標準配置類型的 D3DKMDT_STANDARDALLOCATION_TYPE型別值。

pCreateSharedPrimarySurfaceData

[in]如果 StandardAllocationType 指定D3DKMDT_STANDARDALLOCATION_SHAREDPRIMARYSURFACE，則為D3DKMDT_SHAREDPRIMARYSURFACEDATA結構的指標。

pCreateShadowSurfaceData

[in]如果 StandardAllocationType 指定D3DKMDT_STANDARDALLOCATION_SHADOWSURFACE，則為D3DKMDT_SHADOWSURFACEDATA結構的指標。

pCreateStagingSurfaceData

[in]如果 StandardAllocationType 指定D3DKMDT_STANDARDALLOCATION_STAGINGSURFACE，則為D3DKMDT_STAGINGSURFACEDATA結構的指標。

pCreateGdiSurfaceData

[in]只有在 StandardAllocationType 指定D3DKMDT_STANDARDALLOCATION_GDISURFACE時，才能使用D3DKMDT_GDISURFACEDATA結構的指標。

此成員從 Windows 7 開始可供使用。

pCreateVirtualGpuSurfaceData

如果 StandardAllocationType是D3DKMDT_STANDARDALLOCATION_VIRTUALGPUSURFACE，則為D3DKMDT_VIRTUALGPUSURFACEDATA結構的指標。從 WDDM 2.1 開始提供。

pCreateFenceStorageData

pAllocationPrivateDriverData

[in/out]配置私用數據區塊的指標，描述標準配置類型;否則，這個成員為 NULL。顯示迷你埠驅動程式 DxgkDdiGetStandardAllocationDriverData 函式傳回的配置私用數據取決於驅動程式在 StandardAllocationType 中要求的類型。

AllocationPrivateDriverDataSize

[out] pAllocationPrivateDriverData 指向的配置私用數據大小，以位元組為單位。如果驅動程式將 pAllocationPrivateDriverData 設定為 NULL，驅動程式應該將 AllocationPrivateDriverDataSize 設定為驅動程式描述指定標準配置類型所需的緩衝區大小。

如果驅動程式不會針對標準配置類型使用私人數據，驅動程式可以將 AllocationPrivateDriverDataSize 設定為零。

pResourcePrivateDriverData

[in/out]描述標準配置類型的資源私用數據區塊指標;否則，這個成員為 NULL。顯示迷你埠驅動程式 DxgkDdiGetStandardAllocationDriverData 函式所傳回的資源私用數據取決於驅動程式在 StandardAllocationType 中要求的類型。

ResourcePrivateDriverDataSize

[out] pResourcePrivateDriverData 指向之資源私用數據的大小，以位元組為單位。如果驅動程式將 pResourcePrivateDriverData 設定為 NULL，驅動程式應該將 ResourcePrivateDriverDataSize 設定為驅動程式描述指定標準配置類型所需的緩衝區大小。

如果驅動程式不會針對標準配置類型使用每個資源的私人數據，驅動程式可以將 ResourcePrivateDriverDataSize 設定為零。

PhysicalAdapterIndex

備註

如果顯示迷你埠驅動程式在 pAllocationPrivateDriverData 和 pResourcePrivateDriverData 成員中傳回 NULL，驅動程式應該會傳回驅動程式在 AllocationPrivateDriverDataSize 和 ResourcePrivateDriverDataSize 成員中所需的緩衝區大小。不過，驅動程式不應該變更聯集中DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA包含的標準配置結構內容，以取得所需的緩衝區大小。

雖然驅動程式可以將 ResourcePrivateDriverDataSize 或 AllocationPrivateDriverDataSize 設定為零，但驅動程式無法同時設定為零。