DXGKCB_GETHANDLEPARENT fungsi panggilan balik (d3dkmddi.h)
DXGKCB_GETHANDLEPARENT mengambil sumber daya induk dari alokasi yang ditentukan.
Sintaks
DXGKCB_GETHANDLEPARENT DxgkcbGethandleparent;
D3DKMT_HANDLE DxgkcbGethandleparent(
[in] IN_D3DKMT_HANDLE hAllocation
)
{...}
Parameter
[in] hAllocation
Handel ke alokasi. Handel ini harus berupa handel mode kernel yang ditetapkan subsistem kernel grafis DirectX (Dxgkrnl.sys) untuk alokasi.
Menampilkan nilai
DXGKCB_GETHANDLEPARENT mengembalikan handel khusus subsistem grafis ke sumber daya induk untuk alokasi yang terkait dengan handel yang ditentukan parameter hAllocation .
Jika DXGKCB_GETHANDLEPARENT mengembalikan handel NULL, Dxgkrnl.sys tidak dapat menyelesaikan handel ke sumber daya induk karena alasan seperti kemungkinan berikut:
- Handel yang tidak valid diterima dari driver tampilan mode pengguna karena serangan berbahaya atau beberapa bug lainnya.
- Alokasi memiliki masalah seumur hidup.
Jika handel NULL dikembalikan, driver miniport tampilan harus gagal saat ini menjalankan fungsi DDI dengan STATUS_INVALID_HANDLE.
Keterangan
Agar DXGKCB_GETHANDLEPARENT mengembalikan handel sumber daya, handel dalam hAllocation harus merupakan handel alokasi yang terkait dengan sumber daya; jika tidak, DXGKCB_GETHANDLEPARENT mengembalikan NULL.
DXGKCB_XXX diimplementasikan oleh Dxgkrnl. Untuk menggunakan fungsi panggilan balik ini, panggil DxgkCbGetHandleParent melalui DXGKRNL_INTERFACE.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows Vista (WDDM 1.0) |
Target Platform | Desktop |
Header | d3dkmddi.h (termasuk D3dkmddi.h) |
IRQL | < DISPATCH_LEVEL |