Notes
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
[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 vers un objet d’appareil framework.
Valeur de retour
WdfDeviceWdmGetAttachedDevice retourne un pointeur vers une structure DEVICE_OBJECT WDM. Si le handle d’objet spécifié représente un objet d’appareil physique (PDO), la méthode retourne NULL.
Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.
Remarques
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 retourne.
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’appareil PDO, FDO et l’appareil inférieur suivant d’un appareil.
TraceEvents(
TRACE_LEVEL_INFORMATION,
DBG_PNP,
"PDO(0x%p) FDO(0x%p), Lower(0x%p)\n",
WdfDeviceWdmGetPhysicalDevice(device),
WdfDeviceWdmGetDeviceObject(device),
WdfDeviceWdmGetAttachedDevice(device)
);
Spécifications
| Besoin | Valeur |
|---|---|
| plateforme cible | Universel |
| version minimale de KMDF | 1.0 |
| En-tête | wdfdevice.h (include Wdf.h) |
| Bibliothèque | Wdf01000.sys (voir Versioning de la bibliothèque Framework.) |
| IRQL | <= DISPATCH_LEVEL |
| règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |