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