WdfRequestRequeue-Funktion (wdfrequest.h)

[Gilt für KMDF und UMDF]

Die WdfRequestRequeue-Methode gibt eine E/A-Anforderung an den Kopf der E/A-Warteschlange zurück, von der sie an den Treiber übermittelt wurde.

Syntax

NTSTATUS WdfRequestRequeue(
  [in] WDFREQUEST Request
);

Parameter

[in] Request

Ein Handle für ein Frameworkanforderungsobjekt.

Rückgabewert

WdfRequestRequeue gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt diese Methode möglicherweise einen der folgenden Werte zurück:

Diese Methode gibt möglicherweise auch andere NTSTATUS-Werte zurück.

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

Hinweise

Ein Treiber kann WdfRequestRequeue nur aufrufen, wenn er die manuelle Verteilungsmethode für die E/A-Warteschlange verwendet.

Wenn der Treiber WdfRequestRequeue nach dem Aufruf von WdfIoQueuePurge aufruft, kann der ErneuteInqueue-Versuch erfolgreich sein, bevor die Bereinigung abgeschlossen ist. In Den Versionen 1.9 und früher von KMDF führt diese Sequenz zu einem Absturz des Betriebssystems. Dieses Problem wurde in KMDF Version 1.11 und höher behoben.

Weitere Informationen zu WdfRequestRequeue finden Sie unter Erneutes Stellen von E/A-Anforderungen.

Beispiele

Im folgenden Codebeispiel wird eine angegebene E/A-Anforderung an die Warteschlange zurückgegeben, von der der Treiber die Anforderung empfangen hat.

NTSTATUS status;

status = WdfRequestRequeue(request);

Anforderungen