PVIDEO_HW_GET_CHILD_DESCRIPTOR fungsi panggilan balik (video.h)

Artikel
08/07/2023

HwVidGetVideoChildDescriptor mengembalikan deskriptor, jenis, dan nomor identifikasi untuk perangkat anak tertentu dari adaptor tampilan.

Sintaks

PVIDEO_HW_GET_CHILD_DESCRIPTOR PvideoHwGetChildDescriptor;

VP_STATUS PvideoHwGetChildDescriptor(
  [in]  IN PVOID HwDeviceExtension,
  [in]  IN PVIDEO_CHILD_ENUM_INFO ChildEnumInfo,
  [out] OUT PVIDEO_CHILD_TYPE VideoChildType,
  [out] OUT PUCHAR pChildDescriptor,
  [out] OUT PULONG UId,
  [out] OUT PULONG pUnused
)
{...}

Parameter

[in] HwDeviceExtension

Arahkan ke area penyimpanan per adaptor driver miniport. Untuk informasi selengkapnya, lihat Ekstensi Perangkat.

[in] ChildEnumInfo

Adalah struktur VIDEO_CHILD_ENUM_INFO yang menjelaskan perangkat yang sedang dijumlahkan.

[out] VideoChildType

Penunjuk ke lokasi di mana driver miniport mengembalikan jenis anak yang sedang dijumlahkan. Anggota ini bisa menjadi salah satu hal berikut dari enumerasi VIDEO_CHILD_TYPE:

Nilai	Makna
Monitor	Perangkat anak adalah monitor. Jika driver miniport mendeteksi bahwa monitor memiliki struktur EDID yang mematuhi DDC2 yang terkait dengannya, driver miniport harus mengekstrak informasi EDID dari monitor dan mengembalikannya di buffer tempat pChildDescriptor menunjuk. Driver miniport dapat lebih mudah mendapatkan EDID dari monitor dengan memanggil VideoPortDDCMonitorHelper. Jika monitor yang terdeteksi tidak sesuai dengan DDC2, driver miniport tidak boleh mengembalikan apa pun di pChildDescriptor.
NonPrimaryChip	Dicadangkan untuk penggunaan sistem.
VideoChip	Perangkat anak adalah chip grafis. Driver miniport harus mengembalikan jenis ini ketika ChildEnumInfo.ChildIndex DISPLAY_ADAPTER_HW_ID. Driver miniport tidak boleh mengembalikan apa pun di pChildDescriptor.
Lainnya	Perangkat anak memiliki driver perangkat terpisah yang terkait dengannya. Driver miniport harus mengembalikan pengidentifikasi perangkat keras PnP perangkat sebagai string Unicode dalam buffer tempat pChildDescriptor menunjuk. String ini harus cocok dengan ID perangkat yang ditentukan dalam file INF driver. Ini akan digunakan oleh sistem operasi sebagai ID perangkat keras untuk perangkat ini.

[out] pChildDescriptor

Penunjuk ke buffer tempat driver miniport dapat mengembalikan data yang mengidentifikasi perangkat. Informasi yang dikembalikan tergantung pada jenis anak yang ditentukan dalam VideoChildType. Ukuran buffer ini ditentukan oleh driver port video di anggota ChildDescriptorSizedari VIDEO_CHILD_ENUM_INFO.

[out] UId

Arahkan ke lokasi di mana driver miniport mengembalikan ID perangkat 32-bit unik untuk perangkat ini. Driver miniport harus mengatur UId agar DISPLAY_ADAPTER_HW_ID ketika perangkat adalah adaptor tampilan aktual.

[out] pUnused

Tidak digunakan dan harus diatur ke nol.

Mengembalikan nilai

HwVidGetVideoChildDescriptor mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
VIDEO_ENUM_INVALID_DEVICE	Telepon lagi. Driver miniport tidak dapat menghitung perangkat anak yang diidentifikasi di ChildEnumInfo tetapi ada lebih banyak perangkat yang akan dijumlahkan.
VIDEO_ENUM_MORE_DEVICES	Perangkat anak baru dijumlahkan. Port video akan memanggil HwVidGetVideoChildDescriptor lagi dalam kasus ini.
VIDEO_ENUM_NO_MORE_DEVICES	Driver miniport tidak dapat menghitung perangkat anak yang diidentifikasi di ChildEnumInfo. Hentikan enumerasi. Tidak ada lagi perangkat yang akan dijumlahkan.

Keterangan

Secara default, HwVidGetVideoChildDescriptor tidak dipanggil sampai setelah perangkat dimulai oleh HwVidFindAdapter. Untuk mengizinkan enumerasi anak perangkat sebelum perangkat dimulai, atur anggota AllowEarlyEnumerationdari VIDEO_HW_INITIALIZATION_DATA. Ketika AllowEarlyEnumeration diatur, HwVidGetVideoChildDescriptor dapat dipanggil kapan saja.

HwVidGetVideoChildDescriptor harus melakukan hal berikut:

Tentukan jenis perangkat anak berdasarkan data yang disediakan di ChildEnumInfo, dan kembalikan jenis ini di VideoChildType.
Isi buffer yang menunjuk pChildDescriptor dengan data yang sesuai, tergantung pada nilai VideoChildType.
Tulis nilai 32-bit di UId yang secara unik mengidentifikasi perangkat anak yang sedang dijumlahkan. Driver port video akan meneruskan handel ini kembali ke driver miniport untuk operasi seperti manajemen daya.

HwVidGetVideoChildDescriptor harus dibuat dapat diperbaharui.