DriverEntry de la fonction de pilote de miniport d’affichage

La fonction DriverEntry fournit le sous-système de noyau graphique de Microsoft DirectX avec un ensemble de pointeurs vers des fonctions implémentées par le pilote de miniport d’affichage.

Syntaxe

NTSTATUS DriverEntry(
  _In_ PDRIVER_OBJECT  DriverObject,
  _In_ PUNICODE_STRING RegistryPath
);

Paramètres

DriverObject [in] pointeur vers une structure DRIVER_OBJECT qui représente le pilote formé par la paire de pilotes (miniport d’affichage, port d’affichage).

RegistryPath [in] pointeur vers une structure UNICODE_STRING qui fournit le chemin d’accès à la clé de Registre du pilote.

Valeur renvoyée

DriverEntry appelle DxgkInitialize et doit retourner la valeur retournée par DxgkInitialize.

Remarques

DriverEntry doit effectuer les étapes suivantes :

  1. Allouez une structure DRIVER_INITIALIZATION_DATA et définissez son membre version sur DXGKDDI_INTERFACE_VERSION, qui est défini dans Dispmprt. h.

  2. Renseignez les membres restants de la structure DRIVER_INITIALIZATION_DATA avec des pointeurs vers les fonctions suivantes, qui sont implémentées par le pilote de miniport d’affichage.

  3. Transmettez DriverObject, RegistryPathet la structure DRIVER_INITIALIZATION_DATA remplie à DxgkInitialize.

  4. Retourne la valeur retournée par DxgkInitialize.

La structure DRIVER_INITIALIZATION_DATA n’a pas besoin de rester en mémoire après le retour de DriverEntry .

DriverEntry doit être rendu paginable.

Pour l’interface du pilote KMDOD (mode d’affichage uniquement en mode noyau), la structure KMDDOD_INITIALIZATION_DATA répertorie toutes les fonctions qui peuvent être implémentées par un KMDOD. Toutes ces fonctions, à l’exception de la fonction DxgkDdiPresentDisplayOnly , peuvent également être implémentées par un pilote de miniport d’affichage complet. La fonction DriverEntry du pilote d’affichage seul en mode noyau (KMDOD) fournit des pointeurs de fonction au pilote de port d’affichage en remplissant tous les membres d’une structure de KMDDOD_INITIALIZATION_DATA, puis en passant cette structure à la fonction DxgkInitializeDisplayOnlyDriver .

Notez que, si un KMDOD ne prend pas en charge la fonctionnalité de contrôle VSync, il ne doit pas implémenter certaines fonctions. pour cela, consultez enregistrement d’énergie avec le contrôle VSync.

Les structures et énumérations suivantes sont également utilisées avec les pilotes d’affichage uniquement en mode noyau :

Spécifications

Plateforme cible

Bureau

Version

disponible dans Windows Vista et les versions ultérieures des systèmes d’exploitation Windows.

Bibliothèque

NtosKrnl. lib

DLL

NtosKrnl.exe

Voir aussi

DxgkInitialize

DxgkDdiUnload