Freigeben über

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

  • Artikel

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

Die Drain-Methode weist die Warteschlange an, neue eingehende E/A-Anforderungen abzulehnen und zuzulassen, dass bereits in der Warteschlange befindliche Anforderungen zur Verarbeitung an den Treiber übermittelt werden.

Syntax

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

Parameter

[in, optional] pDrainComplete

Ein Zeiger auf die IQueueCallbackStateChange-Schnittstelle , deren Methode das Framework aufruft, um den Warteschlangenzustand 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 sein.

Rückgabewert

Keine

Bemerkungen

Ein Treiber sollte sicherstellen, dass zu einem bestimmten Zeitpunkt nur eine der folgenden Methoden ausgeführt wird:

Wenn der Treiber beispielsweise zuvor Drain aufgerufen hat, sollte er auf eine Benachrichtigung der -Methode der Schnittstelle warten, auf die der Parameter pDrainComplete zeigt, bevor der Treiber entweder Stop oder Purge aufruft. Wenn Sie gegen diese Regel verstoßen, wird der Hostprozess beendet.

Anforderungen

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

Weitere Informationen

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::P urge

IWDFIoQueue::Stop