Auf Englisch lesen

Freigeben über


IWDFIoQueue::Stop-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 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 nach allen ausstehenden E/A-Anforderungen (sofern vorhanden) im Treiber aufgerufen wird. Dieser Parameter ist optional und kann NULL-werden.

Rückgabewert

Nichts

Bemerkungen

Ein Aufruf von Stop ist asynchron und wird sofort an den Treiber zurückgegeben. Der Treiber wird über die Methode der bereitgestellten IQueueCallbackStateChange Schnittstelle benachrichtigt, nachdem alle ausstehenden Anforderungen im Treiber abgeschlossen wurden.

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

Wenn der Treiber z. B. Stopaufgerufen hat, sollte er auf die Benachrichtigung über die Methode der Schnittstelle warten, auf die der pStopComplete-Parameter verweist, bevor der Treiber entweder Drain aufruft oder Löschen. Ein Verstoß gegen diese Regel führt zum Beenden des Hostprozesses.

Mit der Stop-Methode kann die Warteschlange neue Anforderungen empfangen, auch wenn die Warteschlange keine neuen Anforderungen empfängt, bevor der Treiber Stopaufgerufen hat. Beispielsweise kann ein Treiber IWDFIoQueue::D rainaufrufen, wodurch das Framework das Hinzufügen neuer E/A-Anforderungen zur Warteschlange beendet. Der nachfolgende Aufruf von Stop 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
Mindest-UMDF-Version 1.5
Header- wudfddi.h (include Wudfddi.h)
DLL- WUDFx.dll

Siehe auch

IQueueCallbackStateChange

IWDFIoQueue

IWDFIoQueue::D rain

IWDFIoQueue::P urge