Rutina MRxLowIOSubmit[LOWIO_OP_SHAREDLOCK]

Artículo
06/15/2023

RDBSS llama a la rutina MRxLowIOSubmit[LOWIO_OP_SHAREDLOCK] para solicitar que un redirector de red abra un bloqueo compartido en un objeto de archivo.

Sintaxis

PMRX_CALLDOWN MRxLowIOSubmit[LOWIO_OP_SHAREDLOCK];

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

Parámetros

RxContext [in, out]
Puntero a la estructura RX_CONTEXT. Este parámetro contiene el IRP que solicita la operación.

Valor devuelto

MRxLowIOSubmit[LOWIO_OP_SHAREDLOCK] devuelve STATUS_SUCCESS si se ejecuta correctamente o un valor NTSTATUS adecuado, como uno de los siguientes:

Código devuelto	Descripción
STATUS_CONNECTION_DISCONNECTED	La conexión se desconecta.
STATUS_INSUFFICIENT_RESOURCES	No había recursos suficientes para completar la solicitud.
STATUS_INVALID_BUFFER_SIZE	El tamaño del búfer solicitado era demasiado grande.
STATUS_INVALID_NETWORK_RESPONSE	Se recibió una respuesta no válida del servidor remoto.
STATUS_INVALID_PARAMETER	Se especificó un parámetro no válido en RxContext.
STATUS_LINK_FAILED	Error al intentar volver a conectarse a un servidor remoto para completar la solicitud.
STATUS_NOT_IMPLEMENTED	Esta rutina no se implementa.
STATUS_SHARING_VIOLATION	Se ha producido una infracción de uso compartido.
STATUS_UNSUCCESSFUL	La llamada no se realizó correctamente.

Comentarios

RDBSS llama a MRxLowIOSubmit[LOWIO_OP_SHAREDLOCK] en respuesta a la recepción de una solicitud de IRP_MJ_LOCK_CONTROL con un código menor de IRP_MN_LOCK si IrpSp-Flags> no tiene establecido el SL_EXCLUSIVE_LOCK bit.

Antes de llamar a MRxLowIOSubmit[LOWIO_OP_SHAREDLOCK], RDBSS modifica los siguientes miembros de la estructura de RX_CONTEXT a la que apunta el parámetro RxContext :

El miembro LowIoContext.Operation se establece en LOWIO_OP_SHAREDLOCK.

El miembro LowIoContext.ResourceThreadId se establece en el subproceso del proceso que inició la operación en RDBSS.

El miembro LowIoContext.ParamsFor.Locks.ByteOffset se establece en el valor de IrpSp-Parameters.LockControl.ByteOffset.QuadPart>.

El miembro LowIoContext.ParamsFor.Locks.Key se establece en el valor de IrpSp-Parameters.LockControl.Key>.

El miembro LowIoContext.ParamsFor.Locks.Flags se establece en el valor de IrpSp-Flags>.

El miembro LowIoContext.ParamsFor.Locks.Length se establece en el valor de IrpSp-Parameters.LockControl.Length.QuadPart>.

El miembro LowIoContext.Operation de la estructura RX_CONTEXT especifica la operación de E/S baja que se va a realizar. Es posible que varias de las rutinas de E/S bajas apunten a la misma rutina en un minidirector de red porque el miembro LowIoContext.Operation se puede usar para diferenciar la operación de E/S baja solicitada. Por ejemplo, todas las llamadas de E/S relacionadas con bloqueos de archivo podrían llamar a la misma rutina de E/S baja en el minidirector de red y esta rutina podría usar el miembro LowIoContext.Operation para diferenciar entre la operación de bloqueo y desbloqueo solicitada.

Si la rutina MRxLowIOSubmit[LOWIO_OP_SHAREDLOCK] puede tardar mucho tiempo en completarse, el controlador minidirector de red debe liberar la estructura FCB antes de iniciar la comunicación de red. La estructura FCB se puede liberar llamando a RxReleaseFcbResourceForThreadInMRx. Aunque la rutina MRxLowIOSubmit[LOWIO_OP_SHAREDLOCK] está procesando, se garantiza que el miembro LowIoContext.ResourceThreadId de RX_CONTEXT indique el subproceso del proceso que inició la operación en RDBSS.

El miembro LowIoContext.ResourceThreadId de la estructura RX_CONTEXT se puede usar para liberar la estructura FCB en nombre de otro subproceso. Cuando se completa una rutina asincrónica, se puede liberar la estructura FCB adquirida a partir del subproceso inicial.