WdfDeviceGetIoTarget, fonction (wdfdevice.h)

[S’applique à KMDF et UMDF]

La méthode WdfDeviceGetIoTarget retourne un handle à la cible d’E/S locale d’un pilote de fonction ou de filtre, pour un appareil spécifié.

Syntaxe

WDFIOTARGET WdfDeviceGetIoTarget(
  [in] WDFDEVICE Device
);

Paramètres

[in] Device

Handle pour un objet d’appareil d’infrastructure.

Valeur retournée

Si l’opération réussit, WdfDeviceGetIoTarget retourne un handle à un objet cible d’E/S de framework. Si l’objet d’appareil d’infrastructure spécifié représente un PDO, la méthode retourne NULL.

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

Remarques

Lorsqu’un pilote UMDF envoie une requête créée par un pilote à une cible d’E/S locale, la requête n’a aucun objet fichier associé. Certaines cibles inférieures, telles qu’un PDO brut énuméré hidClass, échouent les demandes qui n’ont aucun objet de fichier associé. Dans ce cas, un pilote UMDF peut spécifier WdfIoTargetOpenLocalTargetByFile pour créer une cible d’E/S qui représente la pile inférieure (comme une cible locale) à l’aide d’un handle de fichier. Par conséquent, toutes les demandes créées par le pilote envoyées à cette cible d’E/S sont associées à l’objet file correspondant au handle ouvert.

Pour ce faire, appelez la fonction WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE avant d’appeler WdfIoTargetOpen.

Pour plus d’informations sur les cibles d’E/S, consultez Utilisation de cibles d’E/S.

Exemples

L’exemple de code suivant obtient un handle pour la cible d’E/S locale d’un appareil spécifié.

WDFIOTARGET  ioTargetHandle;

ioTargetHandle = WdfDeviceGetIoTarget(device);

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
Version UMDF minimale	2.0
En-tête	wdfdevice.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)