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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Disponible en Windows 2000 y versiones posteriores de los sistemas operativos Windows. |
| Plataforma de destino | Escritorio |
| Encabezado | video.h (incluya Video.h) |
| Library | Videoprt.lib |
| Archivo DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |