VideoPortGetDeviceData function (video.h)
The VideoPortGetDeviceData function retrieves system-detected configuration information from the ..\Machine\Hardware\Description tree in the registry. This information is bus-specific or adapter-specific and stored in the registry by the system loader or the HAL.
Syntax
VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetDeviceData(
PVOID HwDeviceExtension,
VIDEO_DEVICE_DATA_TYPE DeviceDataType,
PMINIPORT_QUERY_DEVICE_ROUTINE CallbackRoutine,
PVOID Context
);
Parameters
HwDeviceExtension
Pointer to the miniport driver's device extension.
DeviceDataType
Specifies the type of data being requested as a VIDEO_DEVICE_DATA_TYPE value, typically one of VpBusData, VpControllerData, or VpMonitorData.
The VpControllerData and VpMonitorData values are relevant only on ARC-compliant platforms. Miniport drivers of x86-type video adapters generally specify VpBusData, particularly for adapters on EISA buses. The VpMachineData value is reserved for future use.
CallbackRoutine
Pointer to a driver-supplied HwVidQueryDeviceCallback function to be called with the requested information.
Context
Pointer to a caller-determined context parameter to be passed to the CallbackRoutine. It typically points to the VIDEO_PORT_CONFIG_INFO buffer.
Return value
VideoPortGetDeviceData returns NO_ERROR if it successfully called the miniport driver's HwVidQueryDeviceCallback function with configuration information.
Remarks
VideoPortGetDeviceData cannot be called from a miniport driver's HwVidInterrupt or HwVidTimer functions, or from VideoPortQueueDpc, or from a callback to VideoPortSynchronizeExecution.
The registry tree from which VideoPortGetDeviceData retrieves configuration information is volatile; that is, it is re-created by the system loader or HAL every time the system is loaded. Because this information is collected and stored early in the boot process, the bus-relative configuration information returned by VideoPortGetBusData can be more complete.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Available in Windows 2000 and later versions of the Windows operating systems. |
| Target Platform | Desktop |
| Header | video.h (include Video.h) |
| Library | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |