PVIDEO_HW_START_IO función de devolución de llamada (video.h)

Artículo
03/05/2024

HwVidStartIO procesa el VRP especificado.

Sintaxis

PVIDEO_HW_START_IO PvideoHwStartIo;

BOOLEAN PvideoHwStartIo(
  PVOID HwDeviceExtension,
  PVIDEO_REQUEST_PACKET RequestPacket
)
{...}

Parámetros

HwDeviceExtension

Puntero al área de almacenamiento por adaptador del controlador de miniporte. Para obtener más información, consulte Extensiones de dispositivo.

RequestPacket

Puntero a una estructura de VIDEO_REQUEST_PACKET , que contiene todos los parámetros pasados originalmente a EngDeviceIoControl.

Valor devuelto

HwVidStartIO debe devolver TRUE, lo que indica que ha completado la solicitud.

Comentarios

Cada controlador de minipuerto de vídeo debe tener una función HwVidStartIO .

El controlador de puerto de vídeo llama a HwVidStartIO en respuesta a cada solicitud GDI EngDeviceIoControl , que se origina en el controlador de pantalla correspondiente. Cuando se llama a HwVidStartIO , el controlador de minipuerto posee el paquete de solicitud de vídeo de entrada hasta que completa la operación solicitada. HwVidStartIO debe hacer lo siguiente:

Examine el miembro IoControlCode del VRP para determinar la operación solicitada por el controlador de pantalla.
Compruebe que el VRP InputBufferLength o OutputBufferLength indica un búfer lo suficientemente grande como para satisfacer la solicitud. El controlador de minipuerto debe devolver un error si cualquiera de los búferes es demasiado pequeño.
Satisfacer la solicitud.
Establezca los miembros Status e Information en el VRP y devuelva TRUE.

El controlador de puerto de vídeo del sistema serializa todas las solicitudes. Un controlador de minipuerto no necesita realizar ninguna serialización propia a menos que tenga una función HwVidInterrupt .

Sin embargo, cada función HwVidStartIO del controlador de miniporte debe completar cada operación solicitada o establecer un error adecuado en el StatusBlock de VRP antes de devolver el control.

HwVidStartIO debe ser paginable.