WdfRequestIsCanceled, fonction (wdfrequest.h)

Article
02/27/2024

[S’applique à KMDF et UMDF]

La méthode WdfRequestIsCanceled détermine si le gestionnaire d’E/S a tenté d’annuler une demande d’E/S spécifiée.

Syntaxe

BOOLEAN WdfRequestIsCanceled(
  [in] WDFREQUEST Request
);

Paramètres

[in] Request

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

Valeur retournée

WdfRequestIsCanceled retourne TRUE si le gestionnaire d’E/S a tenté d’annuler la demande d’E/S spécifiée. Cette méthode peut retourner TRUE même si le pilote appelant n’est pas propriétaire de la requête. Si le pilote n’est pas propriétaire de la demande, il ne doit pas appeler WdfRequestIsCanceled. Pour plus d’informations, consultez Remarques.

WdfRequestIsCanceled retourne FALSE pour l’une des raisons suivantes :

Le gestionnaire d’E/S n’a pas tenté d’annuler la demande.
Le pilote appelant n’est pas propriétaire de la demande.
Le pilote appelant a appelé la méthode WdfRequestMarkCancelable ou WdfRequestMarkCancelableEx .

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

Remarques

Si votre pilote n’a pas appelé WdfRequestMarkCancelable ou WdfRequestMarkCancelableEx pour inscrire une fonction de rappel EvtRequestCancel , mais si vous souhaitez que votre pilote détermine si le gestionnaire d’E/S a tenté d’annuler une demande d’E/S, le pilote peut appeler WdfRequestIsCanceled.

Si le pilote a appelé WdfRequestMarkCancelable ou WdfRequestMarkCancelableEx, il doit appeler WdfRequestUnmarkCancelable avant d’appeler WdfRequestIsCanceled.

Un pilote peut appeler WdfRequestIsCanceled pour une requête uniquement si le pilote est propriétaire de la demande d’E/S.

Si WdfRequestIsCanceled retourne TRUE, votre pilote doit annuler la demande en appelant WdfRequestComplete avec un paramètre Status de STATUS_CANCELLED. Si le pilote tente d’effectuer une demande qu’il n’est pas propriétaire, il peut provoquer le blocage du système.

Pour plus d’informations sur WdfRequestIsCanceled, consultez Annulation des demandes d’E/S

Exemples

L’exemple de code suivant appelle WdfRequestComplete si WdfRequestIsCanceled retourne TRUE.

if (WdfRequestIsCanceled(request)) {
    WdfRequestComplete(
                       request,
                       STATUS_CANCELLED
                       );
}

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
Version KMDF minimale	1.0
Version UMDF minimale	2.0
En-tête	wdfrequest.h (inclure 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), ReqIsCancOnCancReq(kmdf)