WdfIoQueueStopAndPurgeSynchronously-Funktion (wdfio.h)
[Gilt für KMDF und UMDF]
Die WdfIoQueueStopAndPurgeSynchronously-Methode verhindert, dass eine E/A-Warteschlange neue E/A-Anforderungen liefert, und bewirkt, dass das Framework vorhandene nicht verarbeitete Anforderungen und treibereigene abbrechbare Anforderungen abbricht, aber die Warteschlange empfängt und speichert neue Anforderungen.
Syntax
void WdfIoQueueStopAndPurgeSynchronously(
[in] WDFQUEUE Queue
);
Parameter
[in] Queue
Ein Handle für ein Framework-Warteschlangenobjekt.
Rückgabewert
Keine
Bemerkungen
Diese Methode gibt zurück, nachdem alle nicht verarbeiteten und treibereigenen Anforderungen (ohne Anforderungen, die der Warteschlange nach diesem Aufruf hinzugefügt wurden) abgeschlossen oder abgebrochen wurden. Wenn neue Anforderungen eingefügt werden, während WdfIoQueueStopAndPurgeSynchronously ausgeführt wird, werden diese neuen Anforderungen erst übermittelt, wenn der Treiber WdfIoQueueStart aufruft.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.11 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfio.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | PASSIVE_LEVEL |
| DDI-Complianceregeln | ChangeQueueState(kmdf), DriverCreate(kmdf), EvtSurpriseRemoveNoSuspendQueue(kmdf), NoCancelFromEvtSurpriseRemove(kmdf) |