WdfIoTargetWdmGetTargetDeviceObject, fonction (wdfiotarget.h)

Article
02/27/2024

[S’applique uniquement à KMDF]

La méthode WdfIoTargetWdmGetTargetDeviceObject retourne un pointeur vers l’objet d’appareil WDM (Windows Driver Model) associé à une cible d’E/S locale ou distante spécifiée.

Syntaxe

PDEVICE_OBJECT WdfIoTargetWdmGetTargetDeviceObject(
  [in] WDFIOTARGET IoTarget
);

Paramètres

[in] IoTarget

Handle vers un objet cible d’E/S local ou distant qui a été obtenu à partir d’un appel précédent à WdfDeviceGetIoTarget ou WdfIoTargetCreate ou à partir d’une méthode qu’une cible d’E/S spécialisée fournit.

Valeur retournée

WdfIoTargetWdmGetTargetDeviceObject retourne un pointeur vers une structure de DEVICE_OBJECT WDM.

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

Remarques

La plupart des pilotes basés sur l’infrastructure n’ont pas besoin d’accéder à l’objet de périphérique WDM d’une cible d’E/S.

Le pointeur retourné par la méthode WdfIoTargetWdmGetTargetDeviceObject est valide jusqu’à ce que le pilote appelle WdfIoTargetClose ou WdfIoTargetCloseForQueryRemove, ou jusqu’à ce que l’objet cible d’E/S distant soit supprimé. Si le pilote fournit une fonction EvtCleanupCallback pour l’objet cible d’E/S distant, et si l’objet est supprimé avant la fermeture de la cible d’E/S distante, le pointeur est valide jusqu’à ce que la fonction EvtCleanupCallback retourne.

Si le pilote tente d’accéder à l’objet de périphérique WDM après sa suppression, le pilote peut provoquer le blocage du système. L’exemple toastmon montre comment le pilote peut fournir une fonction de rappel EvtIoTargetQueryRemove afin qu’il soit averti si la cible d’E/S est supprimée.

Pour plus d’informations sur WdfIoTargetWdmGetTargetDeviceObject, 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 des cibles d’E/S.

Exemples

L’exemple de code suivant vérifie la structure WDM DEVICE_OBJECT d’une cible d’E/S pour vérifier que la cible prend en charge les opérations d’E/S directes.

if (!((WdfIoTargetWdmGetTargetDeviceObject(Adapter->IoTarget))->Flags
 & DO_DIRECT_IO)) {
    ASSERTMSG("Target device doesn't support direct I/O\n", FALSE);
    return STATUS_INVALID_DEVICE_REQUEST;
}

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
En-tête	wdfiotarget.h (inclure Wdf.h)
Bibliothèque	Wdf01000.sys (consultez Gestion de version de la bibliothèque d’infrastructure.)
IRQL	<=DISPATCH_LEVEL
Règles de conformité DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)