VP_STATUS VideoPortGetDeviceData(
| PVOID HwDeviceExtension, | |
| VIDEO_DEVICE_DATA_TYPE DeviceDataType, | |
| PMINIPORT_QUERY_DEVICE_ROUTINE CallbackRoutine, | |
| PVOID Context | |
| ); |
VideoPortGetDeviceData 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.
Parameters
HwDeviceExtension
Points to the miniport driver’s device extension.
DeviceDataType
Specifies the type of data being requested as a VIDEO_DEVICE_DATA_TYPE value. Usually, this is one of the following values:
VpBusData
VpControllerData
VpMonitorData
The VpControllerData and VpMonitorData values have meaning only on ARC-compliant platforms. Miniport drivers of x86-type video adapters usually specify VpBusData, particularly for adapters on EISA or MCA buses. The VpMachineData value is defined for future use.
CallbackRoutine
Points to a driver-supplied HwVidQueryDeviceCallback function to be called with the requested information.
Context
Points to a caller-determined context parameter to be passed to the CallbackRoutine. Usually, it points to the VIDEO_PORT_CONFIG_INFO buffer.
Return Value
VideoPortGetDeviceData returns NO_ERROR if it successfully called the miniport’s HwVidQueryDeviceCallback function with configuration information.
Comments
VideoPortGetDeviceData can be called only from a miniport’s HwVidFindAdapter function.
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.
See Also
HwVidFindAdapter, HwVidQueryDeviceCallback, VIDEO_PORT_CONFIG_INFO, VideoPortGetRegistryParameters