WdfDriverWdmGetDriverObject, fonction (wdfdriver.h)
[S’applique à KMDF uniquement]
La méthode WdfDriverWdmGetDriverObject récupère un pointeur vers l’objet de pilote WDM (Windows Driver Model) associé à un objet pilote d’infrastructure spécifié.
Syntaxe
PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
[in] WDFDRIVER Driver
);
Paramètres
[in] Driver
Handle de l’objet du pilote d’infrastructure du pilote que le pilote a obtenu à partir d’un appel précédent à WdfDriverCreate ou WdfGetDriver.
Valeur retournée
WdfDriverWdmGetDriverObject retourne un pointeur vers une structure DRIVER_OBJECT . Un bogue système case activée se produit si le handle du pilote n’est pas valide.
Remarques
Le pointeur retourné par la méthode WdfDriverWdmGetDriverObject est valide jusqu’à ce que l’objet du pilote d’infrastructure soit supprimé. Si le pilote fournit une fonction EvtCleanupCallback pour l’objet pilote d’infrastructure, le pointeur est valide jusqu’à ce que la fonction de rappel soit retournée.
Exemples
L’exemple de code suivant obtient un pointeur vers l’objet pilote WDM associé à un objet de pilote d’infrastructure spécifié.
PDRIVER_OBJECT pDrvObj;
pDrvObj = WdfDriverWdmGetDriverObject(Driver);
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| En-tête | wdfdriver.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (consultez Gestion des versions de la bibliothèque d’infrastructure).) |
| IRQL | <= DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf) |