VIDEO_HW_INITIALIZATION_DATA struttura (video.h)

Articolo
08/08/2023

La struttura VIDEO_HW_INITIALIZATION_DATA specifica i punti di ingresso e i requisiti di archiviazione per il driver miniport. Questa struttura viene creata nello stack e inizializzata dalla funzione DriverEntry del driver miniport.

Sintassi

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;

Members

HwInitDataSize

Dimensioni in byte di questa struttura. In effetti, questo indica la versione di VIDEO_HW_INITIALIZATION_DATA in uso.

AdapterInterfaceType

Attualmente viene ignorato dalla porta video e deve rimanere zero inizializzato.

HwFindAdapter

Puntatore alla funzione HwVidFindAdapter del driver miniport, necessaria per tutti i driver miniport.

HwInitialize

Puntatore alla funzione HwVidInitialize del driver miniport, necessaria per tutti i driver miniport.

HwInterrupt

Puntatore alla funzione HwVidInterrupt del driver miniport, necessaria solo se la scheda del driver miniport genera interruzioni. In caso contrario, questo puntatore deve essere NULL.

HwStartIO

Puntatore alla funzione HwVidStartIO del driver miniport, necessaria per tutti i driver miniport.

HwDeviceExtensionSize

Specifica le dimensioni in byte del driver miniport di archiviazione necessarie per l'estensione del dispositivo privata e specifica dell'adattatore. Un driver miniport usa questa risorsa di archiviazione per contenere informazioni sui driver determinati per adattatore, ad esempio gli intervalli di indirizzi logici mappati per i registri dell'adattatore e qualsiasi informazione sul contesto gestito dal driver sulle operazioni di I/O.

Un puntatore all'estensione del dispositivo viene passato a ogni chiamata effettuata alle funzioni standard del driver miniport, ad eccezione di DriverEntry, HwVidSynchronizeExecutionCallback e qualsiasi funzione SvgaHwIoPortXxx . Il driver della porta video alloca la memoria per l'estensione del dispositivo e lo inizializza con zero prima che venga passato alla funzione HwVidFindAdapter del driver miniport.

StartingDeviceNumber

Deve essere impostato su zero.

HwResetHw

Puntatore alla funzione HwVidResetHw del driver miniport, necessaria per qualsiasi driver miniport di una scheda che non viene reimpostata completamente in un riavvio soft del computer. Driver di adattatori SVGA che vengono completamente reimpostati in modalità carattere VGA standard in ricezione di un comando INT10, MODE3-type in genere impostato su NULL.

HwTimer

Puntatore a una funzione HwVidTimer del driver miniport, facoltativa. Questo puntatore può essere NULL.

HwStartDma

Riservato per l'utilizzo nel sistema.

HwSetPowerState

Puntatore alla funzione HwVidSetPowerState del driver miniport, necessaria per tutti i driver miniport.

HwGetPowerState

Puntatore alla funzione HwVidGetPowerState del driver miniport, necessaria per tutti i driver miniport.

HwGetVideoChildDescriptor

Puntatore alla funzione HwVidGetVideoChildDescriptor del driver miniport, necessaria per tutti i driver miniport.

HwQueryInterface

Puntatore alla funzione HwVidQueryInterface del driver miniport. Questa operazione può essere implementata facoltativamente in un driver miniport che supporta interfacce di programmazione esterne per la comunicazione tra dispositivi, ad esempio il supporto I2C (o I²C) per i decodificatori MPEG. In caso contrario, questo membro deve essere impostato su NULL.

HwChildDeviceExtensionSize

Dimensione in byte dell'estensione del dispositivo associata al dispositivo di output visualizzato. Il driver miniport deve compilare questo membro solo se il driver miniport deve gestire i dati di configurazione del monitoraggio separatamente dalla configurazione della scheda scheda.

HwLegacyResourceList

Puntatore a una matrice di strutture VIDEO_ACCESS_RANGE . Ogni struttura descrive una porta di I/O del dispositivo o un intervallo di memoria per la scheda video non elencata nello spazio di configurazione PCI.

HwLegacyResourceCount

Numero di elementi nella matrice a cui punta HwLegacyResourceList .

HwGetLegacyResources

Puntatore alla funzione HwVidLegacyResources del driver miniport, che consente al driver di specificare le risorse legacy in base ai relativi ID dispositivo e fornitore.

AllowEarlyEnumeration

Consente al driver miniport di enumerare i dispositivi figlio prima dell'avvio dell'adattatore; ovvero, il driver della porta video può chiamare HwVidGetVideoChildDescriptor prima di HwVidFindAdapter quando questo membro è impostato su TRUE.

Reserved

Riservato per l'utilizzo nel sistema.

Commenti

Una funzione DriverEntry del driver miniport deve inizializzare questa struttura con zero prima di impostare valori pertinenti in qualsiasi membro.

Il driver della porta video ignorerà i membri HwLegacyResourceCount e HwLegacyResourceList quando HwGetLegacyResources viene inizializzato con un puntatore a un'implementazione HwVidLegacyResources.