IWDFIoRequest ::CancelSentRequest, méthode (wudfddi.h)
[Avertissement : UMDF 2 est la dernière version de UMDF et remplace UMDF 1. Tous les nouveaux pilotes UMDF doivent être écrits à l’aide de UMDF 2. Aucune nouvelle fonctionnalité n’est ajoutée à UMDF 1 et il existe une prise en charge limitée de UMDF 1 sur les versions plus récentes de Windows 10. Les pilotes Windows universels doivent utiliser UMDF 2. Pour plus d’informations, consultez Bien démarrer avec UMDF.]
La méthode CancelSentRequest tente d’annuler la demande d’E/S que le pilote a précédemment envoyé à 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 requête. TRUE indique que la requête a été correctement remise. FALSE indique que la requête n’a pas été correctement remise.
Remarques
Un pilote peut appeler CancelSentRequest pour tenter d’annuler la requête d’E/S qu’elle a précédemment envoyée à une cible d’E/S en appelant la méthode IWDFIoRequest ::Send.
Si la demande 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 du 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 le IRequestCallbackRequestCompletion interface pour la routine d’achèvement de la requête, l’infrastructure appelle la routine d’achèvement une fois la requête annulée.
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.5 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |
Voir aussi
IRequestCallbackCancel ::OnCancel
IRequestCallbackRequestCompletion