DXGKCB_ACQUIREHANDLEDATA fungsi panggilan balik (d3dkmddi.h)

Artikel
02/23/2024

DXGKCB_ACQUIREHANDLEDATA memperoleh referensi ke alokasi.

Sintaks

DXGKCB_ACQUIREHANDLEDATA DxgkcbAcquirehandledata;

VOID * DxgkcbAcquirehandledata(
  [in]  IN_CONST_PDXGKARGCB_GETHANDLEDATA unnamedParam1,
  [out] PDXGKARG_RELEASE_HANDLE unnamedParam2
)
{...}

Parameter

[in] unnamedParam1

Penunjuk ke struktur DXGKARGCB_GETHANDLEDATA yang menjelaskan handel alokasi yang dikembalikan oleh DXGKCB_CREATECONTEXTALLOCATION.

[out] unnamedParam2

Penunjuk ke handel rilis untuk digunakan driver saat merilis referensi alokasi.

Menampilkan nilai

Tidak ada.

Keterangan

Handel alokasi dapat dihancurkan kapan saja oleh aplikasi atau oleh panggilan driver mode pengguna ke D3DKMTDestroyAllocation pada handel yang valid. Penghancuran alokasi melibatkan permintaan ke driver mode kernel untuk menghapus objek alokasi yang dikembalikan Dxgkrnl kepada mereka selama pembuatan alokasi, sehingga KMD dapat berakhir dengan pointer basi untuk memori yang dikosongkan. DXGKCB_ACQUIREHANDLEDATA dan DXGKCB_RELEASEHANDLEDATA memungkinkan driver untuk memegang referensi pada objek Dxgkrnl dan memastikan bahwa Dxgkrnl tidak menghancurkan alokasi dan objek terkait KMD sampai setelah panggilan rilis dilakukan.

DXGKCB_XXX diimplementasikan oleh Dxgkrnl. Untuk menggunakan fungsi panggilan balik ini, atur anggota DXGKARGCB_GETHANDLEDATA lalu panggil DxgkCbAcquireHandleData melalui DXGKRNL_INTERFACE.