MRxLowIOSubmit[LOWIO_OP_UNLOCK] Routine

2024-02-02

Die MRxLowIOSubmit[LOWIO_OP_UNLOCK] Routine wird von RDBSS aufgerufen, um anzufordern, dass ein Netzwerkminiumleitungsor eine einzelne Sperre für ein Dateiobjekt entfernt.

Syntax

PMRX_CALLDOWN MRxLowIOSubmit[LOWIO_OP_UNLOCK];

NTSTATUS MRxLowIOSubmit[LOWIO_OP_UNLOCK](
  _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_UNLOCK] gibt STATUS_SUCCESS nach Erfolg oder einen entsprechenden NTSTATUS-Wert zurück, z. B. einen der folgenden:

Rückgabecode	Beschreibung
STATUS_CONNECTION_DISCONNECTED	Die Verbindung wurde getrennt.
STATUS_INSUFFICIENT_RESOURCES	Es waren nicht genügend Ressourcen vorhanden, um die Anforderung abzuschließen.
STATUS_INVALID_NETWORK_RESPONSE	Vom Remoteserver wurde eine ungültige Antwort empfangen.
STATUS_INVALID_PARAMETER	In RxContext wurde ein ungültiger Parameter angegeben.
STATUS_LINK_FAILED	Der Versuch, die Verbindung mit einem Remoteserver wiederherzustellen, um die Anforderung abzuschließen, ist fehlgeschlagen.
STATUS_NOT_IMPLEMENTED	Diese Routine wird nicht implementiert.
STATUS_SHARING_VIOLATION	Es ist eine Freigabeverletzung aufgetreten.
STATUS_UNSUCCESSFUL	Der Aufruf war nicht erfolgreich.

Hinweise

RDBSS ruft MRxLowIOSubmit[LOWIO_OP_UNLOCK] als Reaktion auf den Empfang einer IRP_MJ_LOCK_CONTROL-Anforderung mit dem Nebencode IRP_MN_UNLOCK_SINGLE auf.

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

Der LowIoContext.Operation-Member ist auf LOWIO_OP_UNLOCK festgelegt.

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

Der LowIoContext.ParamsFor.Locks.ByteOffset-Member ist auf den Wert von IrpSp-Parameters.LockControl.ByteOffset.QuadPart> festgelegt.

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

Der LowIoContext.ParamsFor.Locks.Length-Member ist auf den Wert von IrpSp-Parameters.LockControl.Length.QuadPart> festgelegt.

Der LowIoContext.Operation-Member der RX_CONTEXT-Struktur gibt den auszuführenden E/A-Vorgang mit geringem E/A-Wert an. Es ist möglich, dass mehrere der niedrigen E/A-Routinen auf dieselbe Routine in einem Netzwerk-Mini-Redirector verweisen, da dieser LowIoContext.Operation-Member verwendet werden kann, um den angeforderten Vorgang mit niedrigen E/A-Vorgängen zu unterscheiden. Beispielsweise könnten alle E/A-Aufrufe im Zusammenhang mit Dateisperren dieselbe niedrige E/A-Routine im Netzwerkminiumleitungsor aufrufen, und diese Routine könnte den LowIoContext.Operation-Member verwenden, um zwischen dem angeforderten Sperr- und Entsperrvorgang zu unterscheiden.

Wenn die MRxLowIOSubmit[LOWIO_OP_UNLOCK] -Routine lange dauern kann, sollte der Netzwerkminiumleitungstreiber die FCB-Struktur freigeben, bevor die Netzwerkkommunikation gestartet wird. Die FCB-Struktur kann durch Aufrufen von RxReleaseFcbResourceForThreadInMRx freigegeben werden. Während die MRxLowIOSubmit[LOWIO_OP_UNLOCK] -Routine verarbeitet wird, gibt der LowIoContext.ResourceThreadId-Member von RX_CONTEXT garantiert den Thread des Prozesses an, der den Vorgang in RDBSS initiiert hat.

Das LowIoContext.ResourceThreadId-Mitglied von RX_CONTEXT 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.