Partager via


Méthode IWDFIoQueue ::D rain (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 Drain demande à la file d’attente de rejeter les nouvelles demandes d’E/S entrantes et d’autoriser la remise des requêtes déjà 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 l’infrastructure appelle la méthode pour remettre l’état de file d’attente au pilote. L’infrastructure appelle la méthode une fois que toutes les demandes sont terminées ou annulées et que la file d’attente est vide. Ce paramètre est facultatif et peut être NULL.

Valeur de retour

None

Remarques

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

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.

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 ::P urge

IWDFIoQueue ::Stop