WdfDeviceWdmGetDeviceObject, fonction (wdfdevice.h)

[S’applique uniquement à KMDF]

La méthode WdfDeviceWdmGetDeviceObject retourne l’objet d’appareil wdM (Windows Driver Model) associé à un objet d’appareil framework spécifié.

Syntaxe

PDEVICE_OBJECT WdfDeviceWdmGetDeviceObject(
  WDFDEVICE Device
);

Paramètres

Device

Handle vers un objet d’appareil framework.

Valeur de retour

WdfDeviceWdmGetDeviceObject retourne un pointeur vers une structure DEVICE_OBJECT.

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Remarques

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

Exemples

L’exemple de code suivant crée un message de suivi qui contient des pointeurs vers les objets d’appareil WDM qui représentent l’objet PDO et FDO d’un appareil.

TraceEvents(
            TRACE_LEVEL_INFORMATION,
            AMCC_TRACE_INIT,
            "PDO 0x%p, FDO 0x%p",
            WdfDeviceWdmGetPhysicalDevice(device),
            WdfDeviceWdmGetDeviceObject(device)
            );

Spécifications

Voir aussi

WdfDeviceWdmGetPhysicalDevice