WdfIoTargetGetDevice, fonction (wdfiotarget.h)

  • Article

[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)

Voir aussi

WdfDeviceGetIoTarget

WdfIoTargetCreate

WdfUsbTargetDeviceGetIoTarget