DXGKDDI_DESTROYALLOCATION fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

Fungsi DxgkDdiDestroyAllocation merilis alokasi.

Sintaks

DXGKDDI_DESTROYALLOCATION DxgkddiDestroyallocation;

NTSTATUS DxgkddiDestroyallocation(
  [in] IN_CONST_HANDLE hAdapter,
  [in] IN_CONST_PDXGKARG_DESTROYALLOCATION pDestroyAllocation
)
{...}

Parameter

[in] hAdapter

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

[in] pDestroyAllocation

Penunjuk ke struktur DXGKARG_DESTROYALLOCATION yang berisi informasi untuk melepaskan alokasi.

Menampilkan nilai

DxgkDdiDestroyAllocation mengembalikan STATUS_SUCCESS, atau hasil kesalahan yang sesuai jika alokasi tidak berhasil dirilis.

Keterangan

Ketika driver tampilan mode pengguna memanggil fungsi pfnDeallocateCb , subsistem kernel grafis DirectX (yang merupakan bagian dari Dxgkrnl.sys) memanggil fungsi DxgkDdiDestroyAllocation driver miniport untuk melepaskan alokasi. Driver miniport tampilan harus membersihkan struktur data internal dan referensinya ke alokasi. Runtime Microsoft Direct3D memulai panggilan ke manajer memori video (yang juga merupakan bagian dari Dxgkrnl.sys), yang kemudian memanggil penjadwal GPU (yang juga merupakan bagian dari Dxgkrnl.sys) untuk disinkronkan sebelum memori video benar-benar dirilis.

Driver miniport tampilan dapat melepaskan seluruh sumber daya serta alokasi. Untuk menentukan apakah sumber daya harus dirilis, driver miniport tampilan dapat memeriksa apakah bendera DestroyResource diatur dalam anggota Bendera dari struktur DXGKARG_DESTROYALLOCATION yang ditunjukkan parameter pDestroyAllocation . Untuk merilis sumber daya, driver miniport tampilan harus membersihkan handel yang ditentukan anggota DXGKARG_DESTROYALLOCATION hResource . Jika driver miniport tampilan tidak merilis sumber daya, driver dapat mengubah nilai di hResource jika perlu.

DxgkDdiDestroyAllocation harus dibuat dapat dipaginasi.