WdfRequestGetStatus, fonction (wdfrequest.h)

[S’applique à KMDF et UMDF]

La méthode WdfRequestGetStatus retourne l’état d’une requête d’E/S.

Syntaxe

NTSTATUS WdfRequestGetStatus(
  [in] WDFREQUEST Request
);

Paramètres

[in] Request

Handle vers un objet de requête de framework.

Valeur de retour

WdfRequestGetStatus retourne une valeur NTSTATUS. Pour plus d’informations sur la valeur à retourner, consultez la section Remarques suivante.

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

Remarques

La méthode WdfRequestGetStatus retourne l’une des méthodes suivantes :

• Si l’appel d’un pilote à WdfRequestSend réussit, WdfRequestGetStatus retourne la valeur d’état définie par le pilote qui appelle WdfRequestComplete pour terminer la requête spécifiée. Le pilote appelle généralement WdfRequestGetStatus à partir d’une fonction de rappel CompletionRoutine.
• Si l’appel d’un pilote à WdfRequestSend échoue, WdfRequestGetStatus retourne une valeur d’état définie pour décrire l’échec. Le pilote peut appeler WdfRequestGetStatus immédiatement après avoir appelé WdfRequestSend.

Pour plus d’informations sur la saisie semi-automatique des demandes, consultez Fin des requêtes d’E/S.

Exemples

L’exemple de code suivant provient de l’exemple de pilote KbFiltr. Cet exemple envoie une requête d’E/S à une cible d’E/S. Si WdfRequestSend échoue, l’exemple utilise la valeur de retour WdfRequestGetStatus comme entrée pour WdfRequestComplete.

VOID
KbFilter_ForwardRequest(
    IN WDFREQUEST Request,
    IN WDFIOTARGET Target
    )
{
    WDF_REQUEST_SEND_OPTIONS options;
    BOOLEAN ret;
    NTSTATUS status;

    WDF_REQUEST_SEND_OPTIONS_INIT(
                                  &options,
                                  WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET
                                  );

    ret = WdfRequestSend(
                         Request,
                         Target,
                         &options
                         );

    if (ret == FALSE) {
        status = WdfRequestGetStatus (Request);
        DebugPrint(("WdfRequestSend failed: 0x%x\n", status));
        WdfRequestComplete(
                           Request,
                           status
                           );
    }
    return;
}

Exigences

Voir aussi

CompletionRoutine

WdfRequestComplete

WdfRequestSend