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 abbricht und treibereigene abbruchbare Anforderungen abbricht, die Warteschlange empfängt und speichert neue Anforderungen.

Syntax

VOID WdfIoQueueStopAndPurgeSynchronously(
  [in] WDFQUEUE Queue
);

Die Parameter

[in] Queue

Ein Handle zu einem Framework-Warteschlangenobjekt.

Rückgabewert

Nichts

Bemerkungen

Diese Methode gibt zurück, nachdem alle unverarbeiteten und treibereigenen Anforderungen (nicht einschließlich Anforderungen, die der Warteschlange nach abschluss dieses Aufrufs 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 Treiberaufrufe WdfIoQueueStart.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Anforderungen

Siehe auch

WdfIoQueueStopAndPurge