WdfDriverWdmGetDriverObject, fonction (wdfdriver.h)

[S’applique uniquement à KMDF]

La méthode WdfDriverWdmGetDriverObject récupère un pointeur vers l’objet de pilote WDM (Windows Driver Model) associé à un objet de pilote d’infrastructure spécifié.

Syntaxe

PDRIVER_OBJECT WdfDriverWdmGetDriverObject(
  [in] WDFDRIVER Driver
);

Paramètres

[in] Driver

Handle de l’objet du pilote framework que le pilote a obtenu à partir d’un appel précédent à WdfDriverCreate ou WdfGetDriver.

Valeur de retour

WdfDriverWdmGetDriverObject retourne un pointeur vers une structure DRIVER_OBJECT. Une vérification des bogues système se produit si le handle pilote n’est pas valide.

Remarques

Pointeur que la méthode WdfDriverWdmGetDriverObject retourne est valide jusqu’à ce que l’objet du pilote d’infrastructure soit supprimé. Si le pilote fournit une fonction EvtCleanupCallback pour l’objet de pilote d’infrastructure, le pointeur est valide jusqu’à ce que la fonction de rappel retourne.

Exemples

L’exemple de code suivant obtient un pointeur vers l’objet de pilote WDM associé à un objet de pilote d’infrastructure spécifié.

PDRIVER_OBJECT  pDrvObj;

pDrvObj = WdfDriverWdmGetDriverObject(Driver);

Spécifications

Voir aussi

DRIVER_OBJECT

WdfDriverCreate

WdfGetDriver