Fonction DriverEntry d'un pilote de miniport d'affichage
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 :
Allouer une structure DRIVER_INITIALIZATION_DATA et définir son membre Version sur DXGKDDI_INTERFACE_VERSION, qui est défini dans Dispmprt.h.
Renseigner les membres restants de DRIVER_INITIALIZATION_DATA avec des pointeurs vers les fonctions implémentées par le KMD.
Transmettre DriverObject, RegistryPath et la structure DRIVER_INITIALIZATION_DATA renseignée à DxgkInitialize.
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 :
- D3DKMT_MOVE_RECT
- D3DKMT_PRESENT_DISPLAY_ONLY_FLAGS
- DXGK_PRESENT_DISPLAY_ONLY_PROGRESS_ID
- DXGKARG_PRESENT_DISPLAYONLY
- DXGKARGCB_PRESENT_DISPLAYONLY_PROGRESS
Spécifications
| Condition requise | Detail |
|---|---|
| Plateforme cible | Bureau |
| Client minimal pris en charge | Windows Vista |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |