WdfDeviceGetIoTarget, fonction (wdfdevice.h)

[S’applique à KMDF et UMDF]

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

Syntaxe

WDFIOTARGET WdfDeviceGetIoTarget(
  [in] WDFDEVICE Device
);

Paramètres

[in] Device

Handle vers un objet d’appareil framework.

Valeur de retour

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

Une vérification de bogue se produit si le pilote fournit un handle d’objet non valide.

Remarques

Lorsqu’un pilote UMDF envoie une requête créée par le pilote à une cible d’E/S locale, la requête n’a pas d’objet de fichier associé. Certaines cibles inférieures, telles qu’un PDO brut énuméré HIDClass, échouent les requêtes 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 de fichier 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 des cibles d’E/S.

Exemples

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

WDFIOTARGET  ioTargetHandle;

ioTargetHandle = WdfDeviceGetIoTarget(device);

Exigences

Exigence	Valeur
plateforme cible	Universel
version minimale de KMDF	1.0
version minimale de UMDF	2.0
d’en-tête	wdfdevice.h (include 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)