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.
void Stop(
[in, optional] IQueueCallbackStateChange *pStopComplete
);
[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.
Nichts
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:
- IWDFIoQueue::Stop
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.
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 |