Méthode IWDFIoQueue ::Stop (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 Stop empêche une file d’attente d’E/S de remettre des demandes d’E/S, mais la file d’attente reçoit et stocke les nouvelles demandes.

Syntaxe

void Stop(
  [in, optional] IQueueCallbackStateChange *pStopComplete
);

Paramètres

[in, optional] pStopComplete

Pointeur vers l’interface IQueueCallbackStateChange dont la méthode est appelée par l’infrastructure une fois que toutes les demandes d’E/S en suspens, le cas échéant, dans le pilote sont terminées. Ce paramètre est facultatif et peut être NULL.

Valeur de retour

None

Remarques

Un appel à Arrêter est asynchrone et retourne immédiatement au pilote. Le pilote est averti par le biais de la méthode de l’interface IQueueCallbackStateChange fournie une fois toutes les requêtes en suspens dans le pilote terminées.

Le pilote doit s’assurer qu’une seule des méthodes suivantes est en cours à un moment donné :

• IWDFIoQueue ::Stop

• IWDFIoQueue ::D rain

• IWDFIoQueue ::P urge

Par exemple, si le pilote a précédemment appelé Stop, il doit attendre la notification de la méthode de l’interface vers laquelle pointe le paramètre pStopComplete avant que le pilote appelle Drain ou Purge. La violation de cette règle entraîne l’arrêt du processus hôte.

La méthode Stop permet à la file d’attente de recevoir de nouvelles requêtes, même si la file d’attente ne recevait pas de nouvelles demandes avant le pilote appelé Stop. Par exemple, un pilote peut appeler IWDFIoQueue ::D rain, ce qui entraîne l’arrêt de l’ajout de nouvelles demandes d’E/S à la file d’attente. L’appel suivant du pilote Stop entraîne la reprise de l’ajout de requêtes à la file d’attente par l’infrastructure.

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.5
En-tête	wudfddi.h (inclure Wudfddi.h)
DLL	WUDFx.dll

Voir aussi

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue ::D rain

IWDFIoQueue ::P urge