Routine MRxLowIOSubmit[LOWIO_OP_UNLOCK]

Articolo
02/02/2024

La routine MRxLowIOSubmit[LOWIO_OP_UNLOCK] viene chiamata da RDBSS per richiedere che un mini-reindirizzamento di rete rimuove un singolo blocco in un oggetto file.

Sintassi

PMRX_CALLDOWN MRxLowIOSubmit[LOWIO_OP_UNLOCK];

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

Parametri

RxContext [in, out]
Puntatore alla struttura RX_CONTEXT. Questo parametro contiene l'IRP che richiede l'operazione.

Valore restituito

MRxLowIOSubmit[LOWIO_OP_UNLOCK] restituisce STATUS_SUCCESS sull'esito positivo o su un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_CONNECTION_DISCONNECTED	La connessione è stata disconnessa.
STATUS_INSUFFICIENT_RESOURCES	Per completare la richiesta sono state eseguite risorse insufficienti.
STATUS_INVALID_NETWORK_RESPONSE	Una risposta non valida è stata ricevuta dal server remoto.
STATUS_INVALID_PARAMETER	Un parametro non valido è stato specificato in RxContext.
STATUS_LINK_FAILED	Tentativo di riconnessione a un server remoto per completare la richiesta non riuscita.
STATUS_NOT_IMPLEMENTED	Questa routine non viene implementata.
STATUS_SHARING_VIOLATION	Si è verificata una violazione della condivisione.
STATUS_UNSUCCESSFUL	La chiamata non è riuscita.

Commenti

RDBSS chiama MRxLowIOSubmit[LOWIO_OP_UNLOCK] in risposta alla ricezione di una richiesta di IRP_MJ_LOCK_CONTROL con codice secondario di IRP_MN_UNLOCK_SINGLE.

Prima di chiamare MRxLowIOSubmit[LOWIO_OP_UNLOCK], RDBSS modifica i membri seguenti nella struttura RX_CONTEXT a cui punta il parametro RxContext :

Il membro LowIoContext.Operation è impostato su LOWIO_OP_UNLOCK.

Il membro LowIoContext.ResourceThreadId è impostato sul thread del processo che ha avviato l'operazione in RDBSS.

Il membro LowIoContext.ParamsFor.Locks.ByteOffset è impostato sul valore di IrpSp-Parameters.LockControl.ByteOffset.QuadPart>.

Il membro LowIoContext.ParamsFor.Locks.Key è impostato sul valore di IrpSp-Parameters.LockControl.Key>.

Il membro LowIoContext.ParamsFor.Locks.Length è impostato sul valore di IrpSp-Parameters.LockControl.Length.QuadPart>.

Il membro LowIoContext.Operation della struttura RX_CONTEXT specifica l'operazione di I/O bassa da eseguire. È possibile che diverse routine di I/O basse puntino alla stessa routine in un mini-reindirizzamento di rete perché questo membro LowIoContext.Operation può essere usato per distinguere l'operazione di I/O bassa richiesta. Ad esempio, tutte le chiamate di I/O correlate ai blocchi di file potrebbero chiamare la stessa routine di I/O bassa nel mini-reindirizzamento di rete e questa routine potrebbe usare il membro LowIoContext.Operation per distinguere tra l'operazione di blocco e sblocco richiesta.

Se la routine MRxLowIOSubmit[LOWIO_OP_UNLOCK] può richiedere molto tempo per completare, il driver del mini-reindirizzamento di rete deve rilasciare la struttura FCB prima di avviare la comunicazione di rete. La struttura FCB può essere rilasciata chiamando RxReleaseFcbResourceForThreadInMRx. Mentre la routine MRxLowIOSubmit[LOWIO_OP_UNLOCK] sta elaborando, il membro LowIoContext.ResourceThreadId di RX_CONTEXT è garantito indicare il thread del processo che ha avviato l'operazione in RDBSS.

Il membro LowIoContext.ResourceThreadId di RX_CONTEXT può essere usato per rilasciare la struttura FCB per conto di un altro thread. Al termine di una routine asincrona, è possibile rilasciare la struttura FCB acquisita dal thread iniziale.