DXGKDDI_DESCRIBEALLOCATION fungsi panggilan balik (d3dkmddi.h)

Artikel
05/26/2023

Fungsi DxgkDdiDescribeAllocation mengambil informasi tentang alokasi yang ada yang tidak tersedia untuk subsistem kernel grafis Microsoft DirectX.

Sintaks

DXGKDDI_DESCRIBEALLOCATION DxgkddiDescribeallocation;

NTSTATUS DxgkddiDescribeallocation(
  [in]     IN_CONST_HANDLE hAdapter,
  [in/out] INOUT_PDXGKARG_DESCRIBEALLOCATION pDescribeAllocation
)
{...}

Parameter

[in] hAdapter

Handel ke blok konteks yang terkait dengan adaptor tampilan. Driver miniport tampilan sebelumnya menyediakan handel ini ke subsistem kernel grafis DirectX dalam parameter output MiniportDeviceContext dari fungsi DxgkDdiAddDevice .

[in/out] pDescribeAllocation

Penunjuk ke struktur DXGKARG_DESCRIBEALLOCATION yang menjelaskan alokasi yang ada.

Menampilkan nilai

DxgkDdiDescribeAllocation mengembalikan STATUS_SUCCESS jika berhasil; jika tidak, ia mengembalikan salah satu kode kesalahan yang ditentukan dalam Ntstatus.h.

Keterangan

Karena subsistem kernel grafis DirectX tidak selalu mempertahankan rekaman alokasi, subsistem kernel grafis memanggil DxgkDdiDescribeAllocation untuk meminta driver miniport tampilan mengembalikan informasi tentang alokasi yang ada. Saat ini, driver miniport tampilan harus dapat mengembalikan informasi ini untuk alokasi berikut:

Alokasi yang juga merupakan utama (yaitu, alokasi yang dibuat driver tampilan mode pengguna dengan mengatur bendera Bit-field utama di anggota Bendera dari struktur D3DDDI_ALLOCATIONINFO dalam panggilan ke fungsi pfnAllocateCb ).
Alokasi yang mungkin menjadi sumber presentasi (yaitu, alokasi yang diwakili oleh anggota hSource dari struktur DXGKARG_PRESENT dalam panggilan ke fungsi DxgkDdiPresent driver miniport tampilan).

DxgkDdiDescribeAllocation harus dibuat dapat dipaginasi.