VideoPortGetDeviceData 函式 (video.h)
VideoPortGetDeviceData 函式會從 擷取系統偵測到的組態資訊。登錄中的 \Machine\Hardware\Description 樹狀結構。 此資訊是總線特定或配接器特定的,並由系統載入器或 HAL 儲存在登錄中。
語法
VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetDeviceData(
PVOID HwDeviceExtension,
VIDEO_DEVICE_DATA_TYPE DeviceDataType,
PMINIPORT_QUERY_DEVICE_ROUTINE CallbackRoutine,
PVOID Context
);
參數
HwDeviceExtension
迷你埠驅動程式裝置延伸模組的指標。
DeviceDataType
指定要求為VIDEO_DEVICE_DATA_TYPE值的數據類型,通常是其中一個 VpBusData、 VpControllerData 或 VpMonitorData。
VpControllerData 和 VpMonitorData 值僅適用於符合 ARC 規範的平臺。 x86 類型視訊適配卡的迷你埠驅動程式通常會指定 VpBusData,特別是 EISA 總線上的適配卡。 VpMachineData 值保留供日後使用。
CallbackRoutine
驅動程式提供的 HwVidQueryDeviceCallback 函式指標,以要求的資訊呼叫。
Context
要傳遞至 CallbackRoutine 之呼叫端決定之內容參數的指標。 它通常指向 VIDEO_PORT_CONFIG_INFO 緩衝區。
傳回值
VideoPortGetDeviceData 如果已成功呼叫迷你埠驅動程式的 HwVidQueryDeviceCallback 函式,並具有設定資訊,則會傳回NO_ERROR。
備註
VideoPortGetDeviceData 無法從迷你埠驅動程式的 HwVidInterrupt 或 HwVidTimer 函式,或從 VideoPortQueueDpc 或從回呼呼叫 VideoPortSynchronizeExecution 呼叫。
VideoPortGetDeviceData 從中擷取組態資訊的登錄樹狀結構為 volatile;也就是說,系統會在每次載入系統時由系統載入器或 HAL 重新建立。 由於這項資訊會在開機程式初期收集並儲存,因此 VideoPortGetBusData 所傳回的總線相對設定資訊可能更完整。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 適用於 Windows 2000 和更新版本的 Windows 作業系統。 |
目標平台 | 桌面 |
標頭 | video.h (包含 Video.h) |
程式庫 | Videoprt.lib |
Dll | Videoprt.sys |
IRQL | PASSIVE_LEVEL |