MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK] Routine

Artikel
06/15/2023

Die MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK] -Routine wird von RDBSS aufgerufen, um anzufordern, dass ein Netzwerkminiumleitungsor eine exklusive Sperre für ein Dateiobjekt öffnet.

Syntax

PMRX_CALLDOWN MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK];

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

Parameter

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

Rückgabewert

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

Rückgabecode	Beschreibung
STATUS_CONNECTION_DISCONNECTED	Die Verbindung wurde getrennt.
STATUS_INSUFFICIENT_RESOURCES	Es gab nicht genügend Ressourcen, 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 ist nicht implementiert.
STATUS_SHARING_VIOLATION	Ein Verstoß gegen die Freigabe ist aufgetreten.
STATUS_UNSUCCESSFUL	Der Aufruf war nicht erfolgreich.

Hinweise

RDBSS ruft MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK] als Reaktion auf den Empfang einer IRP_MJ_LOCK_CONTROL-Anforderung mit dem Nebencode IRP_MN_LOCK auf, wenn für IrpSp-Flags> das SL_EXCLUSIVE_LOCK Bit festgelegt ist.

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

Der LowIoContext.Operation-Member ist auf LOWIO_OP_EXCLUSIVELOCK festgelegt.

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

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

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

Der LowIoContext.ParamsFor.Locks.Flags-Member wird auf den Wert von IrpSp-Flags> festgelegt.

Der LowIoContext.ParamsFor.Locks.Length-Member wird 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 niedrigem 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 E/A-Low-Vorgang zu unterscheiden. Beispielsweise könnten alle E/A-Aufrufe im Zusammenhang mit Dateisperren dieselbe niedrige E/A-Routine im Netzwerk-Miniumleitungsmodus aufrufen, und diese Routine könnte den LowIoContext.Operation-Member verwenden, um zwischen dem angeforderten Sperr- und Entsperrvorgang zu unterscheiden.

Wenn die Ausführung der MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK] -Routine sehr lange dauern kann, sollte der Netzwerk-Miniumleitungstreiber die FCB-Struktur freigeben, bevor die Netzwerkkommunikation initiiert wird. Die FCB-Struktur kann durch Aufrufen von RxReleaseFcbResourceForThreadInMRx freigegeben werden. Während die MRxLowIOSubmit[LOWIO_OP_EXCLUSIVELOCK] -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-Element 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.