WdfDeviceWdmGetPhysicalDevice, fonction (wdfdevice.h)

[S’applique uniquement à KMDF]

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 vers un objet d’appareil framework.

Valeur de retour

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

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

Remarques

Pointeur indiquant que la méthode WdfDeviceWdmGetPhysicalDevice 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

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

Spécifications