WdfDeviceWdmGetAttachedDevice, fonction (wdfdevice.h)

  • Article

[S’applique uniquement à KMDF]

La méthode WdfDeviceWdmGetAttachedDevice retourne l’objet d’appareil WDM inférieur suivant dans la pile d’appareils.

Syntaxe

PDEVICE_OBJECT WdfDeviceWdmGetAttachedDevice(
  [in] WDFDEVICE Device
);

Paramètres

[in] Device

Handle d’un objet d’appareil framework.

Valeur retournée

WdfDeviceWdmGetAttachedDevice retourne un pointeur vers une structure de DEVICE_OBJECT WDM. Si le handle d’objet spécifié représente un objet d’appareil physique (PDO), la méthode retourne NULL.

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

Remarques

Le pointeur que la méthode WdfDeviceWdmGetAttachedDevice 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 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 le PDO, le FDO et l’appareil suivant.

TraceEvents(
            TRACE_LEVEL_INFORMATION,
            DBG_PNP,
            "PDO(0x%p) FDO(0x%p), Lower(0x%p)\n",
            WdfDeviceWdmGetPhysicalDevice(device),
            WdfDeviceWdmGetDeviceObject(device),
            WdfDeviceWdmGetAttachedDevice(device)
            );

Configuration requise

Condition requise Valeur
Plateforme cible Universal
Version KMDF minimale 1.0
En-tête wdfdevice.h (include Wdf.h)
Bibliothèque Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.)
IRQL <= DISPATCH_LEVEL
Règles de conformité DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Voir aussi

WdfDeviceWdmGetDeviceObject

WdfDeviceWdmGetPhysicalDevice