IQueueCallbackIoCanceledOnQueue ::OnIoCanceledOnQueue, 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 fonction de rappel d’événement OnIoCanceledOnQueue pilote informe le pilote qu’une demande d’E/S a été annulée pendant qu’elle était dans une file d’attente d’E/S.
Syntaxe
void OnIoCanceledOnQueue(
[in] IWDFIoQueue *pWdfQueue,
[in] IWDFIoRequest *pWdfRequest
);
Paramètres
[in] pWdfQueue
Pointeur vers l’interface IWDFIoQueue pour la file d’attente d’E/S dans laquelle la requête d’E/S était en cours d’annulation.
[in] pWdfRequest
Pointeur vers l’interface IWDFIoRequest pour la requête d’E/S.
Valeur de retour
Aucun
Remarques
Un pilote inscrit l’interface IQueueCallbackIoCanceledOnQueue d’une file d’attente d’E/S et OnIoCanceledOnQueue fonction de rappel lorsque le pilote appelle la IWDFDevice ::CreateIoQueue. Pour plus d’informations sur l’inscription de l’interface, consultez IQueueCallbackIoCanceledOnQueue.
Si un pilote inscrit un OnIoCanceledOnQueue fonction de rappel pour une file d’attente d’E/S, l’infrastructure appelle la fonction de rappel si un gestionnaire de demandes reçoit une requête d’E/S à partir d’une file d’attente d’E/S, le pilote appelle IWDFIoRequest ::ForwardToIoQueue ou IWDFIoRequest2 ::Requeue pour requeue la demande à la file d’attente d’E/S pour laquelle la fonction de rappel OnIoCanceledOnQueue est inscrite, et l’opération d’E/S associée est ensuite annulée.
Une fois que l’infrastructure appelle la fonction de rappel OnIoCanceledOnQueue, le pilote possède l’objet de requête et doit donc annuler la requête.
L’infrastructure n’appelle pas le OnIoCanceledOnQueue du pilote fonction de rappel pour les demandes d’E/S que l’infrastructure n’a jamais remises au pilote.
L’infrastructure appelle une fonction de rappel OnIoCanceledOnQue ue dès qu’elle détermine qu’une demande d’E/S a été annulée, quelle que soit la méthode de distribution que le pilote a défini pour la file d’attente d’E/S. Par conséquent, l’infrastructure peut appeler un OnIoCanceledOnQueue fonction de rappel pour une requête dans une file d’attente qui utilise la répartition séquentielle, même si le pilote possède actuellement une autre requête de la file d’attente.
Pour plus d’informations sur la fonction de rappel OnIoCanceledOnQueue, consultez Annulation des requêtes d’E/S.
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) |