VideoPortGetDeviceData function (video.h)

Article
02/22/2024

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