Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
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 driver driverEntry del 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;
Membri
HwInitDataSize
Dimensione in byte di questa struttura. In effetti, indica la versione di VIDEO_HW_INITIALIZATION_DATA in uso.
AdapterInterfaceType
Attualmente viene ignorato dalla porta video e deve rimanere inizializzato zero.
HwFindAdapter
Puntatore alla funzione del driver miniport HwVidFindAdapter, necessaria per tutti i driver miniport.
HwInitialize
Puntatore alla funzione del driver miniport HwVidInitialize, necessaria per tutti i driver miniport.
HwInterrupt
Puntatore alla funzione HwVidInterrupt del driver miniport, necessaria solo se l'adattatore del driver miniport genera interrupt. 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 dello spazio di archiviazione richiesto dal driver miniport per l'estensione del dispositivo privata specifica dell'adattatore. Un driver miniport usa questa risorsa di archiviazione per contenere le informazioni relative alle schede determinate dal driver, ad esempio gli intervalli di indirizzi logici mappati per i registri dell'adattatore e le informazioni sul contesto gestite 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, HwVidSynchronizeExecutionCallbacke qualsiasi Funzioni svgaHwIoPortXxx. Il driver della porta video alloca la memoria per l'estensione del dispositivo e la inizializza con zeri prima che venga passata alla funzione del driver miniport.
StartingDeviceNumber
Deve essere impostato su zero.
HwResetHw
Puntatore al driver miniport funzione HwVidResetHw, necessaria per qualsiasi driver miniport di un adattatore che non reimposta completamente in un riavvio leggero del computer. I driver degli adattatori SVGA completamente reimpostati su una modalità carattere standard VGA alla ricezione di un comando INT10, di tipo MODE3, in genere impostano questa opzione su NULL.
HwTimer
Puntatore alla funzione HwVidTimer di un driver miniport, che è facoltativa. Questo puntatore può essere NULL.
HwStartDma
Riservato per l'uso del sistema.
HwSetPowerState
Puntatore alla funzione di del driver miniport HwVidSetPowerState, necessaria per tutti i driver miniport.
HwGetPowerState
Puntatore alla funzione di del driver miniport HwVidGetPowerState, necessaria per tutti i driver miniport.
HwGetVideoChildDescriptor
Puntatore alla funzione di del driver miniport HwVidGetVideoChildDescriptor, necessaria per tutti i driver miniport.
HwQueryInterface
Puntatore alla funzione del driver miniport HwVidQueryInterface. Questa opzione può essere implementata facoltativamente in un driver miniport che supporta interfacce di programmazione esterne per la comunicazione tra dispositivi, ad esempio supporto di I2C (o I²C) per decodificatori MPEG. In caso contrario, questo membro deve essere impostato su NULL.
HwChildDeviceExtensionSize
Dimensioni in byte dell'estensione del dispositivo associata al dispositivo di output di visualizzazione. 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 punti 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 propri 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'uso del sistema.
Osservazioni
La funzione DriverEntry di un driver miniport deve inizializzare questa struttura con zeri prima di impostare i 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 HwVidacyResources implementazione.
Fabbisogno
| Requisito | Valore |
|---|---|
| intestazione | video.h (includere Video.h) |