WdfDeviceWdmGetDeviceObject, fonction (wdfdevice.h)

  • Article

[S’applique à KMDF uniquement]

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

Syntaxe

PDEVICE_OBJECT WdfDeviceWdmGetDeviceObject(
  WDFDEVICE Device
);

Paramètres

Device

Handle pour un objet d’appareil d’infrastructure.

Valeur retournée

WdfDeviceWdmGetDeviceObject retourne un pointeur vers une structure DEVICE_OBJECT .

Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.

Remarques

Le pointeur retourné par la méthode WdfDeviceWdmGetDeviceObject est valide jusqu’à ce que l’objet d’appareil framework soit supprimé. Si le pilote fournit une fonction EvtCleanupCallback pour l’objet de périphérique d’infrastructure, le pointeur est valide jusqu’à ce que la fonction de rappel soit retournée.

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’AOP et le FDO d’un appareil.

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

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdfdevice.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), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfDeviceWdmGetPhysicalDevice