Fonction VideoPortInitialize (video.h)

Article
02/29/2024

La fonction VideoPortInitialize effectue une partie de l’initialisation du pilote miniport, en allouant des ressources système pour le pilote miniport.

Syntaxe

VIDEOPORT_API ULONG VideoPortInitialize(
  PVOID                         Argument1,
  PVOID                         Argument2,
  PVIDEO_HW_INITIALIZATION_DATA HwInitializationData,
  PVOID                         HwContext
);

Paramètres

Argument1

Pointeur avec lequel le système d’exploitation appelé DriverEntry de Video Miniport Driver.

Argument2

Deuxième pointeur avec lequel le système d’exploitation est appelé DriverEntry.

HwInitializationData

Pointeur vers la structure VIDEO_HW_INITIALIZATION_DATA sur la pile. La routine DriverEntry du pilote miniport a zéro initialisé cette structure, puis l’a renseignée avec des informations de configuration spécifiques au pilote décrivant une carte vidéo que le pilote miniport peut prendre en charge.

HwContext

Doit avoir la valeur NULL.

Valeur retournée

VideoPortInitialize retourne la status finale de l’opération d’initialisation.

Remarques

Chaque pilote de miniport vidéo doit appeler VideoPortInitialize à partir de sa fonction DriverEntry . DriverEntry peut appeler VideoPortInitialize uniquement une fois qu’il a d’abord initialisé zéro, puis configuré la structure VIDEO_HW_INITIALIZATION_DATA . VideoPortInitialize peut être appelé uniquement à partir de la fonction DriverEntry d’un pilote miniport.

Fonction VideoPortInitialize :

Vérifie la validité des spécifications de VIDEO_HW_INITIALIZATION_DATA du pilote miniport.
Alloue de la mémoire pour une structure de VIDEO_PORT_CONFIG_INFO et l’initialise zéro.
Renseigne autant d’informations de configuration de l’adaptateur que possible dans VIDEO_PORT_CONFIG_INFO.
Remplit certains des membres publics de l’objet d’appareil créé par le système pour représenter la carte graphique. Le pilote de port vidéo gère les objets d’appareil. Par conséquent, le pilote miniport n’a pas besoin de se préoccuper des détails de l’objet de l’appareil.
Alloue de la mémoire pour l’objet d’appareil et l’initialise zéro. Une extension de périphérique est la zone de stockage principale et la seule zone de stockage globale de chaque pilote miniport pour les informations d’état spécifiques à l’adaptateur. Le pilote miniport spécifie la taille de l’extension de périphérique dans le membre HwDeviceExtensionSize de VIDEO_HW_INITIALIZATION_DATA. Le pilote de port vidéo transmet cette extension d’appareil à la plupart des fonctions de pilote miniport qu’il appelle.
Collecte et stocke des informations pertinentes dans l’extension de l’appareil.

La routine DriverEntry du pilote miniport propage la valeur retournée par VideoPortInitialize à son appelant. Les pilotes miniports ne doivent pas utiliser cette valeur de retour.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures des systèmes d’exploitation Windows.
Plateforme cible	Desktop (Expérience utilisateur)
En-tête	video.h (inclure Video.h)
Bibliothèque	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL