estrutura VIDEO_HW_INITIALIZATION_DATA (video.h)

Artigo
02/07/2025

A estrutura VIDEO_HW_INITIALIZATION_DATA especifica os pontos de entrada e os requisitos de armazenamento para o driver de miniporto. Essa estrutura é criada na pilha e inicializada pela função DriverEntry do driver do miniport.

Sintaxe

typedef struct _VIDEO_HW_INITIALIZATION_DATA {
  ULONG                          HwInitDataSize;
  INTERFACE_TYPE                 AdapterInterfaceType;
  PVIDEO_HW_FIND_ADAPTER         HwFindAdapter;
  PVIDEO_HW_INITIALIZE           HwInitialize;
  PVIDEO_HW_INTERRUPT            HwInterrupt;
  PVIDEO_HW_START_IO             HwStartIO;
  ULONG                          HwDeviceExtensionSize;
  ULONG                          StartingDeviceNumber;
  PVIDEO_HW_RESET_HW             HwResetHw;
  PVIDEO_HW_TIMER                HwTimer;
  PVIDEO_HW_START_DMA            HwStartDma;
  PVIDEO_HW_POWER_SET            HwSetPowerState;
  PVIDEO_HW_POWER_GET            HwGetPowerState;
  PVIDEO_HW_GET_CHILD_DESCRIPTOR HwGetVideoChildDescriptor;
  PVIDEO_HW_QUERY_INTERFACE      HwQueryInterface;
  ULONG                          HwChildDeviceExtensionSize;
  PVIDEO_ACCESS_RANGE            HwLegacyResourceList;
  ULONG                          HwLegacyResourceCount;
  PVIDEO_HW_LEGACYRESOURCES      HwGetLegacyResources;
  BOOLEAN                        AllowEarlyEnumeration;
  ULONG                          Reserved;
} VIDEO_HW_INITIALIZATION_DATA, *PVIDEO_HW_INITIALIZATION_DATA;

Membros

HwInitDataSize

É o tamanho em bytes dessa estrutura. Na verdade, isso indica a versão de VIDEO_HW_INITIALIZATION_DATA sendo usada.

AdapterInterfaceType

No momento, é ignorado pela porta de vídeo e deve permanecer inicializado zero.

HwFindAdapter

Ponteiro para a função HwVidFindAdapter do driver de miniporto, que é necessária para todos os drivers de miniporto.

HwInitialize

Ponteiro para a função HwVidInitialize do driver de miniporto, que é necessária para todos os drivers de miniporto.

HwInterrupt

Ponteiro para a função HwVidInterrupt do driver de miniporto, que é necessária somente se o adaptador do driver de miniporto gerar interrupções. Caso contrário, esse ponteiro deverá ser NULL.

HwStartIO

Ponteiro para a função HwVidStartIO do driver de miniporto, que é necessária para todos os drivers de miniporto.

HwDeviceExtensionSize

Especifica o tamanho em bytes do armazenamento que o driver de miniporto requer para sua extensão de dispositivo privada específica do adaptador. Um driver de miniporto usa esse armazenamento para conter informações determinadas pelo driver por adaptador, como os intervalos de endereços lógicos mapeados para os registros do adaptador e quaisquer informações de contexto que o driver mantém sobre suas operações de E/S.

Um ponteiro para a extensão do dispositivo é passado em todas as chamadas feitas para as funções padrão do driver de miniport, exceto DriverEntry, HwVidSynchronizeExecutionCallback e qualquer funções de SvgaHwIoPortXxx. O driver de porta de vídeo aloca a memória da extensão do dispositivo e a inicializa com zeros antes de ser passada para a função de HwVidFindAdapter do driver de miniport.

StartingDeviceNumber

Deve ser definido como zero.

HwResetHw

Ponteiro para a função HwVidResetHw do driver de miniporto, que é necessária para qualquer driver de miniportuário de um adaptador que não seja totalmente redefinido em uma reinicialização reversível do computador. Drivers de adaptadores SVGA que são totalmente redefinidos para um modo de caractere padrão VGA no recebimento de um comando INT10, tipo MODE3 geralmente definem isso como NULL.

HwTimer

Ponteiro para a função de HwVidTimer de um driver de miniporto, que é opcional. Esse ponteiro pode ser NULL.

HwStartDma

Reservado para uso do sistema.

HwSetPowerState

Ponteiro para a função HwVidSetPowerState do driver de miniporto, que é necessária para todos os drivers de miniporto.

HwGetPowerState

Ponteiro para a função HwVidGetPowerState do driver de miniporto, que é necessária para todos os drivers de miniporto.

HwGetVideoChildDescriptor

Ponteiro para a função HwVidGetVideoChildDescriptor do driver de miniporto, que é necessária para todos os drivers de miniporto.

HwQueryInterface

Ponteiro para a função de HwVidQueryInterface do driver de miniport. Isso pode ser implementado opcionalmente em um driver de miniporto que dá suporte a interfaces de programação externas para comunicação entre dispositivos, como suporte a I2C (ou I²C) para decodificadores MPEG. Caso contrário, esse membro deverá ser definido como NULL.

HwChildDeviceExtensionSize

É o tamanho em bytes da extensão do dispositivo associada ao dispositivo de saída de exibição. O driver de miniporto deve preencher esse membro somente se o driver de miniporto precisar gerenciar os dados de configuração do monitor separadamente da configuração da placa do adaptador.

HwLegacyResourceList

Ponteiro para uma matriz de estruturas de VIDEO_ACCESS_RANGE. Cada estrutura descreve uma porta de E/S do dispositivo ou um intervalo de memória para o adaptador de vídeo que não está listado no espaço de configuração de PCI.

HwLegacyResourceCount

É o número de elementos na matriz à qual pontos de HwLegacyResourceList.

HwGetLegacyResources

Ponteiro para a função HwVidLegacyResources do driver de miniport, que permite que o driver especifique seus recursos herdados com base em suas IDs de dispositivo e fornecedor.

AllowEarlyEnumeration

Permite que o driver de miniporte enumere seus dispositivos filho antes que o adaptador seja iniciado; ou seja, o driver de porta de vídeo pode chamar HwVidGetVideoChildDescriptor antes de HwVidFindAdapter quando esse membro é definido como TRUE.

Reserved

Reservado para uso do sistema.

Observações

A função DriverEntry de um driver de miniport deve inicializar essa estrutura com zeros antes de definir valores relevantes em qualquer membro.

O driver da porta de vídeo ignorará os HwLegacyResourceCount e membros HwLegacyResourceList quando HwGetLegacyResources for inicializado com um ponteiro para uma implementação HwVidLegacyResources.