DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA結構（d3dkmddi.h）

發行項
11/11/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]如果 StandardAllocation Type 指定D3DKMDT_STANDARDALLOCATION_SHAREDPRIMARYSURFACE，則為 D3DKMDT_SHAREDPRIMARYSURFACEDATA 結構的指標。

pCreateShadowSurfaceData

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

pCreateStagingSurfaceData

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

pCreateGdiSurfaceData

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

此成員從 Windows 7 開始提供。

pCreateVirtualGpuSurfaceData

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

pCreateFenceStorageData

如果 standardAllocationType D3DKMDT_STANDARDALLOCATION_FENCESTORAGE，則為 D3DKMDT_FENCESTORAGESURFACEDATA 結構的指標。從 WDDM 3.2 開始提供。

pAllocationPrivateDriverData

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

AllocationPrivateDriverDataSize

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

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

pResourcePrivateDriverData

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

ResourcePrivateDriverDataSize

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

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

PhysicalAdapterIndex

[in]LDA 組態中的實體配接器索引，存放區將位於其中。

言論

標準配置類型 是必須在核心模式中建立的配置，而不需與使用者模式顯示驅動程序通訊。

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

雖然 KMD 可以設定 ResourcePrivateDriverDataSize 或 AllocationPrivateDriverDataSize 為零，但不能將兩者都設定為零。