DXGKCB_ENUMHANDLECHILDREN fungsi panggilan balik (d3dkmddi.h)

  • Artikel

DXGKCB_ENUMHANDLECHILDREN menghitung alokasi yang terkait dengan sumber daya tertentu, satu alokasi pada satu waktu.

Sintaks

DXGKCB_ENUMHANDLECHILDREN DxgkcbEnumhandlechildren;

D3DKMT_HANDLE DxgkcbEnumhandlechildren(
  [in] IN_CONST_PDXGKARGCB_ENUMHANDLECHILDREN unnamedParam1
)
{...}

Parameter

[in] unnamedParam1

Arahkan ke struktur DXGKARGCB_ENUMHANDLECHILDREN yang menjelaskan sumber daya induk dan indeks alokasi anak untuk diambil.

Menampilkan nilai

DXGKCB_ENUMHANDLECHILDREN mengembalikan handel khusus Dxgkrnl ke alokasi anak yang dijelaskan pData . Untuk mengambil data khusus perangkat untuk handel, driver miniport tampilan harus memanggil fungsi DXGKCB_GETHANDLEDATA .

DXGKCB_ENUMHANDLECHILDREN mengembalikan handel NULL jika nilai indeks alokasi anak yang disediakan dalam anggota Indeks dari struktur DXGKARGCB_ENUMHANDLECHILDREN melebihi jumlah alokasi yang terkait dengan sumber daya induk. Jika DXGKCB_ENUMHANDLECHILDREN secara tidak terduga mengembalikan handel NULL, subsistem kernel grafis DirectX 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 secara tiba-tiba, driver miniport tampilan harus gagal saat ini menjalankan fungsi DDI dengan STATUS_INVALID_HANDLE.

Keterangan

Driver miniport tampilan dapat memanggil DXGKCB_ENUMHANDLECHILDREN dalam perulangan untuk menghitung semua alokasi yang terkait dengan sumber daya.

Indeks gagang alokasi berbasis nol. Jika driver miniport tampilan mengatur pData-Index> ke 0, DXGKCB_ENUMHANDLECHILDREN mengembalikan handel alokasi pertama; jika Indeks diatur ke 1, DXGKCB_ENUMHANDLECHILDREN mengembalikan handel alokasi kedua; dan sebagainya. Jika Indeks lebih besar dari jumlah alokasi yang terkait dengan sumber daya, DXGKCB_ENUMHANDLECHILDREN mengembalikan NULL.

DXGKCB_XXX diimplementasikan oleh Dxgkrnl. Untuk menggunakan fungsi panggilan balik ini, atur anggota DXGKARGCB_ENUMHANDLECHILDREN yang sesuai lalu panggil DxgkCbEnumHandleChildren 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 PASSIVE_LEVEL

Lihat juga

DXGKARGCB_ENUMHANDLECHILDREN

DXGKCB_GETHANDLEDATA

DXGKRNL_INTERFACE