função de retorno de chamada PVIDEO_HW_START_IO (video.h)

Artigo
02/26/2024

HwVidStartIO processa o VRP especificado.

Sintaxe

PVIDEO_HW_START_IO PvideoHwStartIo;

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

Parâmetros

HwDeviceExtension

Ponteiro para a área de armazenamento por adaptador do driver de miniport. Para obter mais informações, consulte Extensões de dispositivo.

RequestPacket

Ponteiro para uma estrutura VIDEO_REQUEST_PACKET , que contém todos os parâmetros originalmente passados para EngDeviceIoControl.

Retornar valor

HwVidStartIO deve retornar TRUE, indicando que ele concluiu a solicitação.

Comentários

Cada driver de miniporto de vídeo deve ter uma função HwVidStartIO .

O driver da porta de vídeo chama HwVidStartIO em resposta a cada solicitação GDI EngDeviceIoControl , que se origina no driver de exibição correspondente. Quando HwVidStartIO é chamado, o driver de miniporto possui o pacote de solicitação de vídeo de entrada até concluir a operação solicitada. HwVidStartIO deve fazer o seguinte:

Examine o membro IoControlCode do VRP para determinar a operação que está sendo solicitada pelo driver de exibição.
Verifique se o InputBufferLength vrp e/ou OutputBufferLength indica um buffer grande o suficiente para atender à solicitação. O driver de miniporte deverá retornar um erro se um dos buffers for muito pequeno.
Satisfaça a solicitação.
Defina os membros status e informações no VRP e retorne TRUE.

O driver de porta de vídeo do sistema serializa todas as solicitações. Um driver de miniporte não precisa executar nenhuma serialização própria, a menos que tenha uma função HwVidInterrupt .

No entanto, a função HwVidStartIO de cada driver de miniporto deve concluir cada operação solicitada ou definir um erro apropriado no StatusBlock do VRP antes de retornar o controle.

HwVidStartIO deve ser tornado paginável.