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

See also

HwVidFindAdapter

HwVidQueryDeviceCallback

VIDEO_PORT_CONFIG_INFO

VideoPortGetRegistryParameters