Méthode IWDFIoRequest2 ::IsCanceled (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 IsCanceled détermine si le gestionnaire d’E/S a tenté d’annuler une demande d’E/S.
Syntaxe
BOOL IsCanceled();
Valeur de retour
IsCanceled retourne TRUE si le gestionnaire d’E/S a tenté d’annuler la demande d’E/S. Cette méthode retourne FALSE pour l’une des raisons suivantes :
- Le gestionnaire d’E/S n’a pas tenté d’annuler la demande.
- Le pilote appelant n’est pas propriétaire de la demande.
- Le pilote appelant a appelé la méthode IWDFIoRequest ::MarkCancelable .
Remarques
Si votre pilote n’a pas appelé IWDFIoRequest ::MarkCancelable pour inscrire une fonction de rappel IRequestCallbackCancel ::OnCancel , mais si vous souhaitez que votre pilote détermine si le gestionnaire d’E/S a tenté d’annuler une demande d’E/S, il peut appeler IsCanceled.
Un pilote peut appeler IsCanceled pour une requête uniquement si le pilote est propriétaire de la demande d’E/S. Si le pilote a appelé IWDFIoRequest ::MarkCancelable, il doit appeler IWDFIoRequest ::UnmarkCancelable avant d’appeler IsCanceled.
Si IsCanceled retourne TRUE, votre pilote doit annuler la demande en appelant IWDFIoRequest ::Complete avec le paramètre CompletionStatus défini sur HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).
Pour plus d’informations sur IsCanceled, consultez Annulation des demandes d’E/S.
Exemples
Dans l’exemple de code suivant, si IsCanceled retourne TRUE, le pilote termine la demande d’E/S en appelant IWDFIoRequest ::Terminer avec une status d’achèvement de HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).
if (fxRequest2->IsCanceled())
{
fxRequest2->Complete(HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED));
}
...
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,9 |
| En-tête | wudfddi.h (inclure Wudfddi.h) |
| DLL | WUDFx.dll |
Voir aussi
IRequestCallbackCancel ::OnCancel