estrutura VIDEO_HW_INITIALIZATION_DATA (video.h)

Artigo
08/08/2023

A estrutura VIDEO_HW_INITIALIZATION_DATA especifica os pontos de entrada e os requisitos de armazenamento para o driver de miniporte. Essa estrutura é criada na pilha e inicializada pela função DriverEntry do driver de 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 com inicialização zero.

HwFindAdapter

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

HwInitialize

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

HwInterrupt

Ponteiro para a função HwVidInterrupt do driver de miniport, 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 miniport, que é necessária para todos os drivers de miniport.

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 quaisquer funções SvgaHwIoPortXxx . O driver da porta de vídeo aloca a memória para a extensão do dispositivo e a inicializa com zeros antes de ser passado para a função HwVidFindAdapter do driver de miniport.

StartingDeviceNumber

Deve ser definido como zero.

HwResetHw

Ponteiro para a função HwVidResetHw do driver de miniport, que é necessária para qualquer driver de miniporto de um adaptador que não é redefinido totalmente em uma reinicialização suave do computador. Drivers de adaptadores SVGA que são totalmente redefinidos para um modo de caractere padrão VGA ao receber um comando INT10, tipo MODE3 geralmente definem isso como NULL.

HwTimer

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

HwStartDma

Reservado para uso do sistema.

HwSetPowerState

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

HwGetPowerState

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

HwGetVideoChildDescriptor

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

HwQueryInterface

Ponteiro para a função 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 miniporte deverá preencher esse membro somente se o driver de miniporto precisar gerenciar os dados de configuração do monitor separadamente da configuração do quadro 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 PCI.

HwLegacyResourceCount

É o número de elementos na matriz para a qual HwLegacyResourceList aponta.

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 estiver definido como TRUE.

Reserved

Reservado para uso do sistema.

Comentários

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 membros HwLegacyResourceCount e HwLegacyResourceList quando HwGetLegacyResources for inicializado com um ponteiro para uma implementação HwVidLegacyResources .