Función VideoPortGetDeviceData (video.h)

La función VideoPortGetDeviceData recupera la información de configuración detectada por el sistema de . . \Machine\Hardware\Description tree in the Registry. Esta información es específica del bus o específica del adaptador y se almacena en el registro mediante el cargador del sistema o HAL.

Sintaxis

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortGetDeviceData(
  PVOID                          HwDeviceExtension,
  VIDEO_DEVICE_DATA_TYPE         DeviceDataType,
  PMINIPORT_QUERY_DEVICE_ROUTINE CallbackRoutine,
  PVOID                          Context
);

Parámetros

HwDeviceExtension

Puntero a la extensión del dispositivo del controlador de minipuerto.

DeviceDataType

Especifica el tipo de datos que se solicitan como un valor de VIDEO_DEVICE_DATA_TYPE, normalmente uno de VpBusData, VpControllerData o VpMonitorData.

Los valores VpControllerData y VpMonitorData solo son relevantes en plataformas compatibles con ARC. Los controladores miniporte de adaptadores de vídeo x86 de tipo generalmente especifican VpBusData, especialmente para adaptadores en autobuses EISA. El valor vpMachineData está reservado para su uso futuro.

CallbackRoutine

Puntero a una función HwVidQueryDeviceCallback proporcionada por el controlador que se va a llamar con la información solicitada.

Context

Puntero a un parámetro de contexto determinado por el autor de la llamada que se va a pasar a CallbackRoutine. Normalmente apunta al búfer de VIDEO_PORT_CONFIG_INFO .

Valor devuelto

VideoPortGetDeviceData devuelve NO_ERROR si llamó correctamente a la función HwVidQueryDeviceCallback del controlador de miniporte con información de configuración.

Comentarios

No se puede llamar a VideoPortGetDeviceData desde las funciones HwVidInterrupt o HwVidTimer del controlador miniportador, o desde VideoPortQueueDpc, o desde una devolución de llamada a VideoPortSynchronizeExecution.

El árbol del Registro del que VideoPortGetDeviceData recupera la información de configuración es volátil; es decir, se vuelve a crear mediante el cargador del sistema o HAL cada vez que se carga el sistema. Dado que esta información se recopila y almacena al principio del proceso de arranque, la información de configuración relativa al bus devuelta por VideoPortGetBusData puede ser más completa.

Requisitos

Consulte también

HwVidFindAdapter

HwVidQueryDeviceCallback

VIDEO_PORT_CONFIG_INFO

VideoPortGetRegistryParameters