struktur DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA (d3dkmddi.h)

Artikel
05/23/2024

Struktur DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA menjelaskan jenis alokasi standar.

Sintaks

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;

Anggota

StandardAllocationType

[in] Nilai jenis D3DKMDT_STANDARDALLOCATION_TYPE yang mengidentifikasi jenis alokasi standar untuk dijelaskan.

pCreateSharedPrimarySurfaceData

[in] Penunjuk ke struktur D3DKMDT_SHAREDPRIMARYSURFACEDATA , jika StandardAllocationType menentukan D3DKMDT_STANDARDALLOCATION_SHAREDPRIMARYSURFACE.

pCreateShadowSurfaceData

[in] Penunjuk ke struktur D3DKMDT_SHADOWSURFACEDATA , jika StandardAllocationType menentukan D3DKMDT_STANDARDALLOCATION_SHADOWSURFACE.

pCreateStagingSurfaceData

[in] Penunjuk ke struktur D3DKMDT_STAGINGSURFACEDATA , jika StandardAllocationType menentukan D3DKMDT_STANDARDALLOCATION_STAGINGSURFACE.

pCreateGdiSurfaceData

[in] Penunjuk ke struktur D3DKMDT_GDISURFACEDATA , hanya tersedia jika StandardAllocationType menentukan D3DKMDT_STANDARDALLOCATION_GDISURFACE.

Anggota ini tersedia dimulai dengan Windows 7.

pCreateVirtualGpuSurfaceData

Arahkan ke struktur D3DKMDT_VIRTUALGPUSURFACEDATA jika StandardAllocationTypeD3DKMDT_STANDARDALLOCATION_VIRTUALGPUSURFACE. Tersedia mulai dari WDDM 2.1.

pCreateFenceStorageData

pAllocationPrivateDriverData

[masuk/keluar] Penunjuk ke blok data privat alokasi yang menjelaskan jenis alokasi standar; jika tidak, anggota ini ADALAH NULL. Data privat alokasi yang ditampilkan fungsi DxgkDdiGetStandardAllocationDriverData driver miniport kembali tergantung pada jenis yang diminta driver di StandardAllocationType.

AllocationPrivateDriverDataSize

[out] Ukuran, dalam byte, dari data privat alokasi yang ditunjukkan pAllocationPrivateDriverData . Jika driver mengatur pAllocationPrivateDriverData ke NULL, driver harus mengatur AllocationPrivateDriverDataSize ke ukuran buffer yang diperlukan driver untuk menjelaskan jenis alokasi standar yang diberikan.

Jika driver tidak menggunakan data privat untuk setiap alokasi untuk jenis alokasi standar, driver dapat mengatur AllocationPrivateDriverDataSize ke nol.

pResourcePrivateDriverData

[masuk/keluar] Penunjuk ke blok data privat sumber daya yang menjelaskan jenis alokasi standar; jika tidak, anggota ini ADALAH NULL. Data privat sumber daya yang ditampilkan fungsi DxgkDdiGetStandardAllocationDriverData driver miniport kembali tergantung pada jenis yang diminta driver di StandardAllocationType.

ResourcePrivateDriverDataSize

[out] Ukuran, dalam byte, dari data privat sumber daya yang dituju oleh pResourcePrivateDriverData . Jika driver mengatur pResourcePrivateDriverData ke NULL, driver harus mengatur ResourcePrivateDriverDataSize ke ukuran buffer yang diperlukan driver untuk menjelaskan jenis alokasi standar yang diberikan.

Jika driver tidak menggunakan data privat untuk setiap sumber daya untuk jenis alokasi standar, driver dapat mengatur ResourcePrivateDriverDataSize ke nol.

PhysicalAdapterIndex

Keterangan

Jika driver miniport tampilan mengembalikan NULL di anggota pAllocationPrivateDriverData dan pResourcePrivateDriverData , driver harus mengembalikan ukuran buffer yang diperlukan driver di anggota AllocationPrivateDriverDataSize dan ResourcePrivateDriverDataSize . Namun, driver tidak boleh mengubah isi struktur alokasi standar dalam serikat yang DXGKARG_GETSTANDARDALLOCATIONDRIVERDATA berisi untuk mendapatkan ukuran buffer yang diperlukan.

Meskipun driver dapat mengatur ResourcePrivateDriverDataSize atau AllocationPrivateDriverDataSize ke nol, driver tidak dapat mengatur keduanya ke nol.