WdfDeviceWdmGetPhysicalDevice, fonction (wdfdevice.h)

[S’applique à KMDF uniquement]

La méthode WdfDeviceWdmGetPhysicalDevice récupère le PDO WDM de l’appareil physique à partir de la pile d’appareils.

Syntaxe

PDEVICE_OBJECT WdfDeviceWdmGetPhysicalDevice(
  [in] WDFDEVICE Device
);

Paramètres

[in] Device

Handle pour un objet d’appareil d’infrastructure.

Valeur retournée

WdfDeviceWdmGetPhysicalDevice 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.

WdfDeviceWdmGetPhysicalDevice retourne NULL si l’appelant fournit un objet d’appareil de contrôle.

Remarques

Le pointeur que la méthode WdfDeviceWdmGetPhysicalDevice retourne est valide jusqu’à ce que l’objet d’appareil d’infrastructure 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

Pour obtenir un exemple de code qui utilise WdfDeviceWdmGetPhysicalDeviceDevice, consultez WdfDeviceWdmGetAttachedDevice.

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)