DriverEntry de la fonction Display Miniport Driver

  • Article

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

Syntaxe

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

Paramètres

DriverObject [in] Pointeur vers une structure de 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 retourné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. Passez DriverObject, RegistryPath et la structure DRIVER_INITIALIZATION_DATA renseignée à 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 kmDOD (display-only driver) 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 complet. La fonction DriverEntry du pilote d’affichage seul en mode noyau (KMDOD) fournit des pointeurs de fonction vers le pilote de port d’affichage en remplissant tous les membres d’une structure 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. Consultez Économiser de l’énergie avec le contrôle VSync.

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

Configuration requise

Plateforme cible

 Desktop (Expérience utilisateur)

Version

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

Bibliothèque

 NtosKrnl.lib

DLL

 NtosKrnl.exe

Voir aussi

DxgkInitialize

DxgkDdiUnload