DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA 結構 (d3dkmddi.h)

發行項
02/23/2024

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

語法

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

成員

[in] StandardAllocationType

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

[in] pCreateSharedPrimarySurfaceData

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

[in] pCreateShadowSurfaceData

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

[in] pCreateStagingSurfaceData

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

[in] pCreateGdiSurfaceData

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

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

pCreateVirtualGpuSurfaceData

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

[in/out] pAllocationPrivateDriverData

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

[out] AllocationPrivateDriverDataSize

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

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

[in/out] pResourcePrivateDriverData

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

[out] ResourcePrivateDriverDataSize

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

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

PhysicalAdapterIndex

備註

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

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