Partager via


Méthode IWDFIoRequest ::CancelSentRequest (wudfddi.h)

[Avertissement : UMDF 2 est la dernière version d’UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide d’UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et la prise en charge d’UMDF 1 est limitée sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Prise en main avec UMDF.]

La méthode CancelSentRequest tente d’annuler la demande d’E/S que le pilote a précédemment envoyée à une cible d’E/S.

Syntaxe

BOOL CancelSentRequest();

Valeur de retour

CancelSentRequest retourne une valeur BOOL qui indique si la demande d’annulation a été correctement remise au propriétaire de la demande. TRUE indique que la demande a été remise avec succès. FALSE indique que la demande n’a pas été remise avec succès.

Remarques

Un pilote peut appeler CancelSentRequest pour tenter d’annuler la demande d’E/S qu’il a précédemment envoyée à une cible d’E/S en appelant la méthode IWDFIoRequest ::Send .

Si la requête se trouve dans la file d’attente de la cible d’E/S, l’infrastructure annule la demande. Si l’infrastructure a déjà remis la requête au pilote de la cible d’E/S et si ce pilote a précédemment appelé IWDFIoRequest ::MarkCancelable pour activer l’annulation, l’infrastructure appelle la méthode IRequestCallbackCancel ::OnCancel de ce pilote. Si le pilote de la cible n’a pas appelé IWDFIoRequest ::MarkCancelable, la demande n’est pas annulée, sauf si la demande devient par la suite annulable.

Si le pilote a précédemment inscrit l’interface IRequestCallbackRequestCompletion pour la routine d’achèvement de la demande, l’infrastructure appelle la routine d’achèvement après l’annulation de la demande.

Configuration requise

Condition requise Valeur
Fin de la prise en charge Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible Desktop (Expérience utilisateur)
Version UMDF minimale 1.5
En-tête wudfddi.h (inclure Wudfddi.h)
DLL WUDFx.dll

Voir aussi

IRequestCallbackCancel ::OnCancel

IRequestCallbackRequestCompletion

IWDFIoRequest

IWDFIoRequest ::MarkCancelable

IWDFIoRequest ::Send