WdfIoTargetGetDevice, fonction (wdfiotarget.h)
[S’applique à KMDF et UMDF]
La méthode WdfIoTargetGetDevice retourne un handle à l’objet d’appareil d’infrastructure qui est le parent de la cible d’E/S locale ou distante spécifiée.
Syntaxe
WDFDEVICE WdfIoTargetGetDevice(
[in] WDFIOTARGET IoTarget
);
Paramètres
[in] IoTarget
Handle vers un objet cible d’E/S. Ce handle est obtenu à partir de WdfDeviceGetIoTarget, WdfIoTargetCreate ou d’une méthode qu’une cible d’E/S spécialisée fournit (telle que WdfUsbTargetDeviceGetIoTarget).
Valeur retournée
WdfIoTargetGetDevice retourne un handle à un objet d’appareil d’infrastructure.
Un bogue case activée se produit si le pilote fournit un handle d’objet non valide.
Remarques
Pour plus d’informations sur WdfIoTargetGetDevice, consultez Obtention d’informations sur une cible d’E/S générale.
Pour plus d’informations sur les cibles d’E/S, consultez Utilisation de cibles d’E/S.
Exemples
L’exemple de code suivant montre comment une fonction de rappel EvtIoTargetQueryRemove peut appeler WdfIoTargetGetDevice.
NTSTATUS
MyEvtIoTargetQueryRemove(
WDFIOTARGET IoTarget
)
{
WDFDEVICE device;
...
device = WdfIoTargetGetDevice(IoTarget);
...
}
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| Version KMDF minimale | 1.0 |
| Version UMDF minimale | 2.0 |
| En-tête | wdfiotarget.h (inclure Wdf.h) |
| Bibliothèque | Wdf01000.sys (KMDF) ; WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| Règles de conformité DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |