DXGKCB_GETHANDLEPARENT fungsi panggilan balik (d3dkmddi.h)

  • Artikel

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

Lihat juga

DXGKRNL_INTERFACE