WdfDeviceWdmGetAttachedDevice, fonction (wdfdevice.h)
[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) |