VideoPortGetDeviceData

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