WdfIoTargetWdmGetTargetFileObject, fonction (wdfiotarget.h)

[S’applique uniquement à KMDF]

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

Syntaxe

PFILE_OBJECT WdfIoTargetWdmGetTargetFileObject(
  [in] WDFIOTARGET IoTarget
);

Paramètres

[in] IoTarget

Handle vers un objet cible d’E/S distant. Ce handle a été obtenu à partir d’un appel précédent à WdfIoTargetCreate.

Valeur de retour

WdfIoTargetWdmGetTargetFileObject retourne un pointeur vers une structure FILE_OBJECT WDM.

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

Remarques

Le pointeur que la méthode WdfIoTargetWdmGetTargetFileObject retourne 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 une fois qu’il a été supprimé, le pilote peut provoquer le blocage du système. L’exemple toastmon montre comment le pilote peut fournir un EvtIoTargetQueryRemove fonction de rappel afin qu’il soit averti si la cible d’E/S est supprimée.

Pour plus d’informations sur WdfIoTargetWdmGetTargetFileObject, consultez Obtenir des 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 obtient un pointeur vers l’objet de fichier WDM associé à une cible d’E/S distante.

PFILE_OBJECT pfileObject;

pfileObject = WdfIoTargetWdmGetTargetFileObject(IoTarget);

Spécifications

Voir aussi

FILE_OBJECT

WdfIoTargetCreate

WdfIoTargetWdmGetTargetDeviceObject

WdfIoTargetWdmGetTargetFileHandle