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

Voir aussi

IRequestCallbackCancel ::OnCancel

IRequestCallbackRequestCompletion

IWDFIoRequest

IWDFIoRequest ::MarkCancelable

IWDFIoRequest ::Send