IWDFIoQueue ::Stop, 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 Arrêter 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 de nouvelles requêtes.
Syntaxe
void Stop(
[in, optional] IQueueCallbackStateChange *pStopComplete
);
Paramètres
[in, optional] pStopComplete
Pointeur vers l’interface IQueueCallbackStateChange dont la méthode appelle l’infrastructure après toutes les demandes d’E/S en attente, le cas échéant, dans le pilote. Ce paramètre est facultatif et peut être NULL.
Valeur de retour
Aucun
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 après l’exécution de toutes les demandes en attente dans le pilote.
Le pilote doit s’assurer qu’une seule des méthodes suivantes est en cours à tout moment :
- IWDFIoQueue ::Stop
La méthode Arrêter permet à la file d’attente de recevoir de nouvelles demandes, même si la file d’attente ne recevait pas de nouvelles demandes avant que le pilote ait appelé Arrêter. Par exemple, un pilote peut appeler IWDFIoQueue ::D rain, ce qui entraîne l’arrêt de l’ajout de nouvelles requêtes d’E/S à la file d’attente. L’appel suivant du pilote de Arrêter entraîne la reprise de l’infrastructure en ajoutant des requêtes à la file d’attente.
Exigences
| Exigence | Valeur |
|---|---|
| fin du support | Indisponible dans UMDF 2.0 et versions ultérieures. |
| plateforme cible | Bureau |
| version minimale de UMDF | 1.5 |
| d’en-tête | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |