WdfIoQueueStopSynchronously-Funktion (wdfio.h)

[Gilt für KMDF und UMDF]

Die WdfIoQueueStopSynchronously-Methode verhindert, dass eine E/A-Warteschlange E/A-Anforderungen liefert, aber die Warteschlange empfängt und speichert neue Anforderungen. Die Methode gibt zurück, nachdem alle übermittelten Anforderungen abgebrochen oder abgeschlossen wurden.

Syntax

void WdfIoQueueStopSynchronously(
  [in] WDFQUEUE Queue
);

Parameter

[in] Queue

Ein Handle für ein Framework-Warteschlangenobjekt.

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Mit der WdfIoQueueStopSynchronously-Methode kann die Warteschlange neue Anforderungen empfangen, auch wenn die Warteschlange keine neuen Anforderungen empfangen hat, bevor der Treiber WdfIoQueueStopSynchronously aufgerufen wurde. Beispielsweise kann ein Treiber WdfIoQueueDrain aufrufen, wodurch das Framework das Hinzufügen neuer E/A-Anforderungen zur Warteschlange beendet. Der nachfolgende Aufruf von WdfIoQueueStopSynchronously des Treibers bewirkt, dass das Framework das Hinzufügen von Anforderungen zur Warteschlange fortsetzen kann.

Rufen Sie WdfIoQueueStopSynchronously nicht aus den folgenden Warteschlangenobjekt-Ereignisrückruffunktionen auf, unabhängig von der Warteschlange, der die Ereignisrückruffunktion zugeordnet ist:

EvtIoDefaultEvtIoDeviceControlEvtIoInternalDeviceControlEvtIoReadEvtIoWrite Weitere Informationen zur WdfIoQueueStopSynchronously-Methode finden Sie unter Verwalten von E/A-Warteschlangen.

Beispiele

Im folgenden Codebeispiel wird eine angegebene Warteschlange beendet.

WdfIoQueueStopSynchronously(WriteQueue);

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
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), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), NoCancelFromEvtSurpriseRemove(kmdf)

Weitere Informationen

WdfIoQueueStart

WdfIoQueueStop