Fungsi VideoPortGetDeviceData (video.h)
Fungsi VideoPortGetDeviceData mengambil informasi konfigurasi yang terdeteksi sistem dari .. \Machine\Hardware\Description tree di registri. Informasi ini khusus bus atau khusus adaptor dan disimpan dalam registri oleh pemuat sistem atau HAL.
Sintaks
VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetDeviceData(
PVOID HwDeviceExtension,
VIDEO_DEVICE_DATA_TYPE DeviceDataType,
PMINIPORT_QUERY_DEVICE_ROUTINE CallbackRoutine,
PVOID Context
);
Parameter
HwDeviceExtension
Arahkan ke ekstensi perangkat driver miniport.
DeviceDataType
Menentukan jenis data yang diminta sebagai nilai VIDEO_DEVICE_DATA_TYPE, biasanya salah satu VpBusData, VpControllerData, atau VpMonitorData.
Nilai VpControllerData dan VpMonitorData hanya relevan pada platform yang mematuhi ARC. Driver miniport adaptor video jenis x86 umumnya menentukan VpBusData, terutama untuk adaptor pada bus EISA. Nilai VpMachineData dicadangkan untuk digunakan di masa mendatang.
CallbackRoutine
Pointer ke fungsi HwVidQueryDeviceCallback yang disediakan driver untuk dipanggil dengan informasi yang diminta.
Context
Arahkan ke parameter konteks yang ditentukan pemanggil untuk diteruskan ke CallbackRoutine. Biasanya menunjuk ke buffer VIDEO_PORT_CONFIG_INFO .
Nilai kembali
VideoPortGetDeviceData mengembalikan NO_ERROR jika berhasil memanggil fungsi HwVidQueryDeviceCallback driver miniport dengan informasi konfigurasi.
Keterangan
VideoPortGetDeviceData tidak dapat dipanggil dari fungsi HwVidInterrupt atau HwVidTimer driver miniport, atau dari VideoPortQueueDpc, atau dari panggilan balik ke VideoPortSynchronizeExecution.
Pohon registri tempat VideoPortGetDeviceData mengambil informasi konfigurasi tidak stabil; artinya, ini dibuat ulang oleh pemuat sistem atau HAL setiap kali sistem dimuat. Karena informasi ini dikumpulkan dan disimpan di awal proses boot, informasi konfigurasi relatif bus yang dikembalikan oleh VideoPortGetBusData bisa lebih lengkap.
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 |