WdfIoQueueRetrieveRequestByFileObject-Funktion (wdfio.h)

[Gilt für KMDF und UMDF]

Die WdfIoQueueRetrieveRequestByFileObject Methode ruft die nächste verfügbare E/A-Anforderung aus einer angegebenen E/A-Warteschlange ab, die einem angegebenen Dateiobjekt zugeordnet ist.

Syntax

NTSTATUS WdfIoQueueRetrieveRequestByFileObject(
  [in]  WDFQUEUE      Queue,
  [in]  WDFFILEOBJECT FileObject,
  [out] WDFREQUEST    *OutRequest
);

Die Parameter

[in] Queue

Ein Handle zu einem Framework-Warteschlangenobjekt.

[in] FileObject

Ein Handle zu einem Framework-Dateiobjekt.

[out] OutRequest

Ein Zeiger auf eine Position, die ein Handle zu einem Framework-Anforderungsobjekt empfängt. Wenn WdfIoQueueRetrieveRequestByFileObject keine STATUS_SUCCESS zurückgibt, wird der Wert des Speicherorts nicht festgelegt.

Rückgabewert

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

Diese Methode kann auch andere NTSTATUS-Wertezurückgeben.

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

Bemerkungen

Ein Treiber, der eine E/A-Warteschlange für manuelle oder sequenzielle Verteiler konfiguriert hat, kann WdfIoQueueRetrieveRequestByFileObjectaufrufen. Weitere Informationen zum Verwenden von WdfIoQueueRetrieveRequestByFileObject mit den manuellen oder sequenziellen Verteilermethoden finden Sie unter Dispatching Methods for I/O Requests.

Nachdem Sie WdfIoQueueRetrieveRequestByFileObject aufgerufen haben, um eine E/A-Anforderung abzurufen, besitzt der Treiber der Anforderung und muss die E/A-Anforderung auf irgendeine Weise verarbeiten .

Weitere Informationen zur WdfIoQueueRetrieveRequestByFileObject--Methode finden Sie unter Managing I/O Queues.

Beispiele

Im folgenden Codebeispiel wird aus einer angegebenen E/A-Warteschlange ein Handle zum nächsten Framework-Anforderungsobjekt abgerufen, das einem angegebenen Framework-Dateiobjekt zugeordnet ist.

WDFREQUEST  request;

status = WdfIoQueueRetrieveRequestByFileObject(
                                               queue,
                                               fileObject,
                                               &request
                                               );

Anforderungen

Siehe auch

WdfIoQueueRetrieveFoundRequest

WdfIoQueueRetrieveNextRequest