IWDFIoRequest2 ::IsCanceled, 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 IsCanceled détermine si le gestionnaire d’E/S a tenté d’annuler une requête 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 faux pour l’une des raisons suivantes :
- Le gestionnaire d’E/S n’a pas tenté d’annuler la demande.
- Le pilote appelant ne possède pas la requête.
- Le pilote appelant a appelé la méthode IWDFIoRequest ::MarkCancelable.
Remarques
Si votre pilote n’a pas appelé IWDFIoRequest ::MarkCancelable pour inscrire une requête d’E/S IRequestCallbackCancel ::OnCancel fonction de rappel, mais si vous souhaitez que votre pilote détermine si le gestionnaire d’E/S a tenté d’annuler une demande d’E/S, le pilote peut appeler IsCanceled.
Un pilote peut appeler IsCanceled pour une demande uniquement si le pilote possè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 requête 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 l’annulation des demandes d’E/S.
Exemples
Dans l’exemple de code suivant, si IsCanceled retourne TRUE, le pilote termine la requête d’E/S en appelant IWDFIoRequest ::Complete avec un état d’achèvement de HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED).
if (fxRequest2->IsCanceled())
{
fxRequest2->Complete(HRESULT_FROM_WIN32(ERROR_OPERATION_ABORTED));
}
...
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.9 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |
Voir aussi
IRequestCallbackCancel ::OnCancel