WdfRequestChangeTarget, fonction (wdfrequest.h)

[S’applique à KMDF et UMDF]

La méthode WdfRequestChangeTarget vérifie qu’une demande d’E/S spécifiée peut être envoyée à une cible d’E/S spécifiée.

Syntaxe

NTSTATUS WdfRequestChangeTarget(
  [in] WDFREQUEST  Request,
  [in] WDFIOTARGET IoTarget
);

Paramètres

[in] Request

Handle pour un objet de requête d’infrastructure.

[in] IoTarget

Handle pour un objet cible d’E/S de framework.

Valeur retournée

WdfRequestChangeTarget retourne STATUS_SUCCESS si l’opération réussit. Sinon, cette méthode peut retourner l’une des valeurs suivantes :

Cette méthode peut également retourner d’autres valeurs NTSTATUS.

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

Remarques

Votre pilote doit appeler la méthode WdfRequestChangeTarget avant d’appeler WdfRequestSend, si le pilote envoie une seule requête d’E/S à plusieurs cibles d’E/S. WdfRequestChangeTarget vérifie que la demande peut être envoyée à la cible d’E/S spécifiée.

La plupart des pilotes envoient chaque requête à un seul appareil et donc à une seule cible d’E/S. Un pilote reçoit la demande ou crée une nouvelle requête en appelant WdfRequestCreate.

Si le pilote envoie la demande à un appareil, il appelle WdfDeviceGetIoTarget pour déterminer la cible d’E/S de l’appareil, puis appelle WdfRequestSend pour envoyer la demande à la cible.

Si le pilote envoie la demande à plusieurs appareils, il appelle WdfDeviceGetIoTarget pour chaque appareil afin de déterminer la cible d’E/S de l’appareil. Avant d’appeler WdfRequestSend, le pilote doit appeler WdfRequestChangeTarget pour s’assurer que chaque cible d’E/S est accessible.

Pour plus d’informations sur WdfRequestChangeTarget, consultez Transfert des demandes d’E/S.

Exemples

L’exemple de code suivant vérifie qu’une demande d’E/S peut être envoyée à la cible d’E/S locale d’un appareil spécifié.

NTSTATUS  status;

status = WdfRequestChangeTarget(
                                request,
                                WdfDeviceGetIoTarget(Device)
                                );

Configuration requise

Voir aussi

WdfDeviceGetIoTarget

WdfRequestCreate

WdfRequestSend