IWDFIoQueue::D rain, 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 Prise en main avec UMDF.]

La méthode Drain dirige la file d’attente pour rejeter les nouvelles demandes d’E/S entrantes et autoriser les demandes déjà mises en file d’attente à être remises au pilote pour le traitement.

Syntaxe

void Drain(
  [in, optional] IQueueCallbackStateChange *pDrainComplete
);

Paramètres

[in, optional] pDrainComplete

Pointeur vers l’interface IQueueCallbackStateChange dont la méthode appelle l’infrastructure pour remettre l’état de file d’attente au pilote. L’infrastructure appelle la méthode une fois toutes les demandes terminées ou annulées et la file d’attente est vide. Ce paramètre est facultatif et peut être NULL.

Valeur de retour

None

Notes

Un pilote doit s’assurer qu’une seule des méthodes suivantes est en cours à tout moment :

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

Spécifications

   
Fin de la prise en charge Non disponible dans UMDF 2.0 et versions ultérieures.
Plateforme cible Bureau
Version UMDF minimale 1.5
En-tête wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Voir aussi

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::P urge

IWDFIoQueue::Stop