Partager via

Fonction DriverEntry d'un pilote de miniport d'affichage

  • Article

La fonction DriverEntry fournit au sous-système de noyau graphique DirectX (Dxgkrnl) un ensemble de pointeurs vers des fonctions implémentées par le pilote de miniport d'affichage (KMD).

Syntaxe

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

Paramètres

DriverObject est un pointeur vers une structure DRIVER_OBJECT qui représente le pilote formé par la paire de pilotes (affichage miniport, port d'affichage).

RegistryPath est un pointeur vers une structure UNICODE_STRING qui fournit le chemin d'accès vers la clé de registre du pilote.

Valeur retournée

DriverEntry doit retourner la valeur retournée par l'appel à DxgkInitialize.

Notes

DriverEntry doit accomplir les étapes suivantes :

  1. Allouer une structure DRIVER_INITIALIZATION_DATA et définir son membre Version sur DXGKDDI_INTERFACE_VERSION, qui est défini dans Dispmprt.h.

  2. Renseigner les membres restants de DRIVER_INITIALIZATION_DATA avec des pointeurs vers les fonctions implémentées par le KMD.

  3. Transmettre DriverObject, RegistryPath et la structure DRIVER_INITIALIZATION_DATA renseignée à DxgkInitialize.

  4. Retourner 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.

DriverEntry pour un pilote d'affichage seul en mode noyau

Pour l'interface du pilote d'affichage seul en mode noyau (KMDOD), 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 DxgkDdiPresentDisplayOnly, peuvent également être implémentées par un pilote de miniport d'affichage complet (KMD). La fonction DriverEntry du KMDOD fournit des pointeurs de fonction vers le pilote de port d'affichage en remplissant tous les membres de KMDDOD_INITIALIZATION_DATA, puis en transmettant cette structure à la fonction DxgkInitializeDisplayOnlyDriver.

Si un KMDOD ne prend pas en charge la fonctionnalité de contrôle VSync, il ne doit pas implémenter certaines fonctions. Se reporter à Économiser de l'énergie avec le contrôle VSync.

Les structures et l'énumération suivantes sont également utilisées avec des KMDOD :

Spécifications

Condition requise Detail
Plateforme cible Bureau
Client minimal pris en charge Windows Vista
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe

Voir aussi

DxgkInitialize

DxgkDdiUnload