EVT_WDF_REQUEST_CANCEL fonction de rappel (wdfrequest.h)

Article
02/27/2024

[S’applique à KMDF et UMDF]

La fonction de rappel d’événement EvtRequestCancel d’un pilote gère les opérations qui doivent être effectuées lorsqu’une demande d’E/S est annulée.

Syntaxe

EVT_WDF_REQUEST_CANCEL EvtWdfRequestCancel;

void EvtWdfRequestCancel(
  [in] WDFREQUEST Request
)
{...}

Paramètres

[in] Request

Handle pour un objet de demande d’infrastructure qui représente la demande d’E/S en cours d’annulation.

Valeur de retour

None

Remarques

Pour inscrire une fonction de rappel EvtRequestCancel , le pilote doit appeler WdfRequestMarkCancelable ou WdfRequestMarkCancelableEx.

Lorsque l’infrastructure appelle la fonction de rappel EvtRequestCancel de votre pilote, si le pilote peut annuler la demande, il doit :

Terminez ou arrêtez le traitement de la demande, ainsi que les sous-requêtes qu’elle a pu créer.
Appelez WdfRequestComplete en spécifiant une valeur status de STATUS_CANCELLED.

Pour plus d’informations sur cette fonction de rappel, consultez Annulation des demandes d’E/S.