Funzione VideoPortInitialize (video.h)

Articolo
02/26/2024

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.

La routine driver DriverEntry del miniport propaga il valore restituito da VideoPortInitialize al chiamante. I driver miniport non devono usare questo valore restituito.

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