VIDEO_HW_INITIALIZATION_DATA struttura (video.h)
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.
Requisiti
Requisito | Valore |
---|---|
Intestazione | video.h (includere Video.h) |