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)

Voir aussi

DRIVER_OBJECT

WdfDriverCreate

WdfGetDriver