IWDFIoQueue ::D rain, méthode (wudfddi.h)

Article
02/07/2025

[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 Drain dirige la file d’attente pour rejeter les nouvelles demandes d’E/S entrantes et autoriser la remise des demandes déjà mises en file d’attente au pilote pour 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

Aucun

Remarques

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

IWDFIoQueue ::Stop
IWDFIoQueue ::D rain
IWDFIoQueue ::P urge

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 le paramètre pDrainCom plete pointe avant que le pilote appelle Arrêter ou purge. La violation de cette règle entraîne l’arrêt du processus hôte.

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

Voir aussi

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue ::P urge

IWDFIoQueue ::Stop

Partager via