MRxLowIOSubmit[LOWIO_OP_READ] Routine

Artikel
06/15/2023

Die MRxLowIOSubmit[LOWIO_OP_READ] -Routine wird von RDBSS aufgerufen, um eine Leseanforderung an den Netzwerkminiumleitungsor ausstellen zu können.

Syntax

PMRX_CALLDOWN MRxLowIOSubmit[LOWIO_OP_READ];

NTSTATUS MRxLowIOSubmit[LOWIO_OP_READ](
  _Inout_ PRX_CONTEXT RxContext
)
{ ... }

Parameter

RxContext [ein, aus]
Ein Zeiger auf die RX_CONTEXT-Struktur. Dieser Parameter enthält die IRP, die den Vorgang anfordert.

Rückgabewert

MRxLowIOSubmit[LOWIO_OP_READ] gibt bei Erfolg STATUS_SUCCESS oder einen entsprechenden NTSTATUS-Wert zurück, z. B. einen der folgenden:

Rückgabecode	Beschreibung
STATUS_FILE_CLOSED	Die FCB-Struktur wurde erworben, aber die zugehörige SRV_OPEN Struktur wurde geschlossen.
STATUS_INSUFFICIENT_RESOURCES	Es waren nicht genügend Ressourcen vorhanden, um die Anforderung abzuschließen.
STATUS_INVALID_DEVICE_REQUEST	Es wurde eine ungültige Geräteanforderung angegeben.
STATUS_INVALID_PARAMETER	In RxContext wurde ein ungültiger Parameter angegeben.
STATUS_NOT_IMPLEMENTED	Diese Routine wird nicht implementiert.
STATUS_NOT_SUPPORTED	Die angegebene Anforderung wird vom Netzwerkminiumleitungsor nicht unterstützt.

Hinweise

RDBSS ruft MRxLowIOSubmit[LOWIO_OP_READ] als Reaktion auf den Empfang einer IRP_MJ_READ-Anforderung auf.

Vor dem Aufrufen von MRxLowIOSubmit[LOWIO_OP_READ]ändert RDBSS die folgenden Member in der RX_CONTEXT Struktur, auf die der RxContext-Parameter verweist:

Der LowIoContext.Operation-Member ist auf LOWIO_OP_READ festgelegt.

Der LowIoContext.ResourceThreadId-Member ist auf den Thread des Prozesses festgelegt, der den Vorgang in RDBSS initiiert hat.

Der LowIoContext.ParamsFor.ReadWrite.Key-Member ist auf den Wert von IrpSp-Parameters.Read.Key> festgelegt.

Das ParamsFor.ReadWrite.Flags-Element hat das LOWIO_READWRITEFLAG_PAGING_IO Bit ist auf festgelegt, wenn Irp-Flags> das IRP_PAGING_IO Bit aktiviert hat.

Der ParamsFor.ReadWrite.Buffer-Member ist auf den Benutzerpuffer festgelegt, der für IoReadAccess gesperrt ist.

Der LowIoContext.ParamsFor.ReadWrite.ByteCount-Member ist auf den Wert von IrpSp-Parameters.Read.Length> festgelegt.

Eine Leseanforderung wird normalerweise von einem Netzwerkminiumleitungsor als asynchroner Vorgang implementiert, da sie viel Zeit in Anspruch nehmen kann. Der Vorgang besteht in der Regel aus dem Senden einer Netzwerkanforderung an den Remoteserver. Die Antwort wird abgerufen, wenn die Leseanforderung auf dem Server abgeschlossen ist. Dies ist ein Beispiel für einen Vorgang, für den der Netzwerkminiumleitungsor möglicherweise einen Kontext für die Behandlung lokal initiierter Abbrüche registrieren muss.

Während die MRxLowIOSubmit[LOWIO_OP_READ] -Routine verarbeitet wird, gibt das LowIoContext.ResourceThreadId-Mitglied von RX_CONTEXT garantiert den Thread des Prozesses an, der den Vorgang in RDBSS initiiert hat. Das LowIoContext.ResourceThreadId-Member kann verwendet werden, um die FCB-Struktur im Namen eines anderen Threads freizugeben. Wenn eine asynchrone Routine abgeschlossen ist, kann die FCB-Struktur, die aus dem anfänglichen Thread abgerufen wurde, freigegeben werden. Die FCB-Struktur kann durch Aufrufen von RxReleaseFcbResourceForThreadInMRx freigegeben werden.