IWDFIoQueue::Stop-Methode (wudfddi.h)

Artikel
02/27/2024

[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 für neuere 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 Stop-Methode verhindert, dass eine E/A-Warteschlange E/A-Anforderungen liefert, aber die Warteschlange empfängt und speichert neue Anforderungen.

Syntax

void Stop(
  [in, optional] IQueueCallbackStateChange *pStopComplete
);

Parameter

[in, optional] pStopComplete

Ein Zeiger auf die IQueueCallbackStateChange-Schnittstelle , deren Methode das Framework aufruft, nachdem alle ausstehenden E/A-Anforderungen (falls vorhanden) im Treiber abgeschlossen sind. Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

Keine

Bemerkungen

Ein Aufruf von Stop ist asynchron und kehrt sofort zum Treiber zurück. Der Treiber wird über die -Methode der bereitgestellten IQueueCallbackStateChange-Schnittstelle benachrichtigt, nachdem alle ausstehenden Anforderungen im Treiber abgeschlossen sind.

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

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

Die Stop-Methode ermöglicht es der Warteschlange, neue Anforderungen zu empfangen, auch wenn die Warteschlange keine neuen Anforderungen empfangen hat, bevor der Treiber Stopp aufgerufen wurde. Beispielsweise kann ein Treiber IWDFIoQueue::D rain aufrufen, wodurch das Framework das Hinzufügen neuer E/A-Anforderungen zur Warteschlange beendet. Der nachfolgende Aufruf von Stop des Treibers bewirkt, dass das Framework das Hinzufügen von Anforderungen zur Warteschlange fortsetzen kann.

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::D rain

IWDFIoQueue::P urge

Freigeben über