Méthode IQueueCallbackIoCanceledOnQueue ::OnIoCanceledOnQueue (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 fonction de rappel d’événement OnIoCanceledOnQueue d’un pilote informe le pilote qu’une demande d’E/S a été annulée alors qu’elle se trouvait 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 se trouvait la demande d’E/S lors de son annulation.

[in] pWdfRequest

Pointeur vers l’interface IWDFIoRequest pour la demande d’E/S.

Valeur de retour

None

Remarques

Un pilote enregistre l’interface IQueueCallbackIoCanceledOnQueue d’une file d’attente d’E/S et la fonction de rappel OnIoCanceledOnQueue lorsque le pilote appelle IWDFDevice ::CreateIoQueue. Pour plus d’informations sur l’inscription de l’interface, consultez IQueueCallbackIoCanceledOnQueue.

Si un pilote inscrit une fonction de rappel OnIoCanceledOnQueue pour une file d’attente d’E/S, l’infrastructure appelle la fonction de rappel si un gestionnaire de demandes reçoit une demande d’E/S à partir d’une file d’attente d’E/S, le pilote appelle IWDFIoRequest ::ForwardToIoQueue ou IWDFIoRequest2 ::Requeue pour renvoyer 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 a appelé la fonction de rappel OnIoCanceledOnQueue , le pilote est propriétaire de l’objet de requête et, par conséquent, doit annuler la demande.

L’infrastructure n’appelle pas la fonction de rappel OnIoCanceledOnQueue du pilote pour les demandes d’E/S que l’infrastructure n’a jamais remises au pilote.

L’infrastructure appelle une fonction de rappel OnIoCanceledOnQueue dès qu’elle détermine qu’une demande d’E/S a été annulée, quelle que soit la méthode de répartition définie par le pilote pour la file d’attente d’E/S. Par conséquent, l’infrastructure peut appeler une fonction de rappel OnIoCanceledOnQueue 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 demandes d’E/S.

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)

Voir aussi

IQueueCallbackIoCanceledOnQueue

IWDFDevice ::CreateIoQueue

IWDFIoRequest ::ForwardToIoQueue