IWDFIoQueue::D rain-Methode (wudfddi.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF-.]

Die Drain-Methode leitet die Warteschlange an, neue eingehende E/A-Anforderungen abzulehnen und bereits in die Warteschlange eingereihte Anforderungen zur Verarbeitung an den Treiber zu senden.

Syntax

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

Parameter

[in, optional] pDrainComplete

Ein Zeiger auf die IQueueCallbackStateChange Schnittstelle, deren Methode das Framework aufruft, um den Warteschlangenstatus an den Treiber zu übermitteln. Das Framework ruft die Methode auf, nachdem alle Anforderungen abgeschlossen oder abgebrochen wurden und die Warteschlange leer ist. Dieser Parameter ist optional und kann NULL-werden.

Rückgabewert

Nichts

Bemerkungen

Ein Treiber sollte sicherstellen, dass immer nur eine der folgenden Methoden ausgeführt wird:

Wenn der Treiber beispielsweise zuvor Drainaufgerufen hat, sollte er auf die Benachrichtigung der Methode der Schnittstelle warten, auf die der pDrainComplete-Parameter verweist, bevor der Treiber entweder Stop aufruft oder Löschen. Ein Verstoß gegen diese Regel führt zum Beenden des Hostprozesses.

Anforderungen

Anforderung Wert
Ende des Supports In UMDF 2.0 und höher nicht verfügbar.
Zielplattform- Desktop
Mindest-UMDF-Version 1.5
Header- wudfddi.h (include Wudfddi.h)
DLL- WUDFx.dll

Siehe auch

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::P urge

IWDFIoQueue::Stop