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
Commentaires
https://aka.ms/ContentUserFeedback.
Bientôt disponible : Tout au long de 2024, nous allons supprimer progressivement GitHub Issues comme mécanisme de commentaires pour le contenu et le remplacer par un nouveau système de commentaires. Pour plus d’informations, consultezEnvoyer et afficher des commentaires pour