Funzione VideoPortInitialize (video.h)
La funzione VideoPortInitialize esegue parte dell'inizializzazione del driver miniport, allocando le risorse di sistema per il driver miniport.
Sintassi
VIDEOPORT_API ULONG VideoPortInitialize(
PVOID Argument1,
PVOID Argument2,
PVIDEO_HW_INITIALIZATION_DATA HwInitializationData,
PVOID HwContext
);
Parametri
Argument1
Puntatore con cui il sistema operativo denominato DriverEntry di Video Miniport Driver.
Argument2
Secondo puntatore con cui il sistema operativo denominato DriverEntry.
HwInitializationData
Puntatore alla struttura VIDEO_HW_INITIALIZATION_DATA nello stack. La routine DriverEntry del driver miniport ha inizializzato zero questa struttura e quindi l'ha compilata con informazioni di configurazione specifiche del driver che descrivono una scheda video che il driver miniport può supportare.
HwContext
Deve essere NULL.
Valore restituito
VideoPortInitialize restituisce lo stato finale dell'operazione di inizializzazione.
Commenti
Ogni driver miniport video deve chiamare VideoPortInitialize dalla funzione DriverEntry . DriverEntry può chiamare VideoPortInitialize solo dopo aver prima inizializzato zero e quindi configurare la struttura di VIDEO_HW_INITIALIZATION_DATA . VideoPortInitialize può essere chiamato solo da una funzione DriverEntry del driver miniport.
Funzione VideoPortInitialize :
- Verifica la validità delle specifiche VIDEO_HW_INITIALIZATION_DATA del driver miniport.
- Alloca la memoria per e inizializza una struttura di VIDEO_PORT_CONFIG_INFO .
- Inserisce tutte le informazioni di configurazione dell'adattatore che può essere in VIDEO_PORT_CONFIG_INFO.
- Inserisce alcuni membri pubblici dell'oggetto dispositivo creato dal sistema per rappresentare la scheda grafica. Il driver della porta video gestisce gli oggetti del dispositivo, pertanto, il driver miniport non deve essere interessato ai dettagli dell'oggetto dispositivo.
- Alloca la memoria per e inizializza l'estensione del dispositivo dell'oggetto device. Un'estensione del dispositivo è ogni miniport driver primario e solo un'area di archiviazione globale per informazioni sullo stato specifiche dell'adattatore. Il driver miniport specifica le dimensioni dell'estensione del dispositivo nel membro HwDeviceExtensionSize di VIDEO_HW_INITIALIZATION_DATA. Il driver della porta video passa questa estensione del dispositivo alla maggior parte delle funzioni del driver miniport che chiama.
- Raccoglie e archivia informazioni pertinenti nell'estensione del dispositivo.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows. |
| Piattaforma di destinazione | Desktop |
| Intestazione | video.h (includere Video.h) |
| Libreria | Videoprt.lib |
| DLL | Videoprt.sys |
| IRQL | PASSIVE_LEVEL |