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

Artigo
03/05/2024

HwVidInitialize executa a primeira inicialização do adaptador, depois que o HAL desistiu do controle do hardware de vídeo para o driver da porta de vídeo.

Sintaxe

PVIDEO_HW_INITIALIZE PvideoHwInitialize;

BOOLEAN PvideoHwInitialize(
  PVOID HwDeviceExtension
)
{...}

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.

Retornar valor

Se a inicialização for bem-sucedida, HwVidInitialize retornará TRUE.

Comentários

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

O driver da porta de vídeo chama HwVidInitialize em resposta a uma solicitação aberta pelo driver de exibição correspondente. Assim que HwVidInitialize é chamado, o driver de miniport pode alterar o estado do adaptador, ao contrário da função HwVidFindAdapter do driver de miniport, que deve deixar o adaptador no modo VGA. No retorno de HwVidInitialize, o adaptador deve ser inicializado para um estado equivalente ao configurado pela função HwVidResetHw do driver de miniport. Esse recurso é usado pela adetização automática para obter informações de modo do driver de miniport.

Se possível, HwVidInitialize deve evitar a programação do hardware do dispositivo. O driver de miniporte inicializará o dispositivo posteriormente, quando for instruído a alternar os modos de exibição.

HwVidInitialize deve ser tornado paginável.