Fungsi VideoPortDDCMonitorHelper (video.h)

Artikel
03/05/2024

Mengkueri monitor untuk informasi EDID menggunakan protokol DDC.

Sintaks

VIDEOPORT_DEPRECATED VIDEOPORT_API BOOLEAN VideoPortDDCMonitorHelper(
  [in]      IN PVOID      HwDeviceExtension,
  [in]      IN PVOID      DDCControl,
  [in, out] IN OUT PUCHAR EdidBuffer,
  [in]      IN ULONG      EdidBufferSize
);

Parameter

[in] HwDeviceExtension

Penunjuk ke ekstensi perangkat driver miniport.

[in] DDCControl

Penunjuk ke struktur DDC_CONTROL .

[in, out] EdidBuffer

Penunjuk ke buffer tempat driver port video mengembalikan struktur EDID . Untuk perangkat ACPI, empat byte pertama telah ditetapkan oleh driver port video untuk menunjukkan upaya untuk membaca EDID.

[in] EdidBufferSize

Ukuran dalam byte buffer tempat EdidBuffer menunjuk.

Nilai kembali

VideoPortDDCMonitorHelper mengembalikan TRUE jika berhasil.

Keterangan

Catatan

Fungsi ini ada sebelum rilis Windows XP, tetapi telah diubah.

Fungsi HwVidGetVideoChildDescriptor driver miniport video dapat memanggil VideoPortDDCMonitorHelper untuk bantuan dalam membaca struktur EDID dari monitor yang mematuhi DDC2. VideoPortDDCMonitorHelper mengimplementasikan detail membaca struktur EDID sesuai dengan spesifikasi I²C, tetapi harus memanggil kembali ke driver miniport video untuk membaca dan menulis bit data individual ke jam seri dan baris data I²C.

Empat fungsi, yang diimplementasikan oleh driver miniport video, yang membaca dan menulis bit individual ke jam I²C dan garis data adalah ReadClockLine, ReadDataLine, WriteClockLine, dan WriteDataLine. Ketika driver miniport video memanggil VideoPortDDCMonitorHelper, ia memasok pointer ke empat fungsi tersebut di DDCControl->I2CCallbacks.

EDID dapat diperoleh menggunakan metode ACPI_METHOD_OUTPUT_DDC yang aliasnya didefinisikan dalam Dispmprt.h. Metode ini diperlukan untuk LCD terintegrasi yang tidak memiliki mekanisme standar lain untuk mengembalikan data EDID.

Dalam buffer 256-byte, pemanggil fungsi ini dapat menerima:

Satu EDID 128-byte
Dua EDID 128-byte
Satu EDID 256-byte (dari tampilan P&D)
Tidak ada EDID

Penelepon harus selalu meminta 256 byte penuh, karena tidak mungkin untuk membaca hanya blok 128-byte kedua dari segmen.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Windows 2000 dan versi yang lebih baru dari sistem operasi Windows.
Target Platform	Desktop
Header	video.h (sertakan Video.h)
Pustaka	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL