Routine MRxLowIOSubmit[LOWIO_OP_READ]

Articolo
02/02/2024

La routine MRxLowIOSubmit[LOWIO_OP_READ] viene chiamata da RDBSS per inviare una richiesta di lettura al mini-reindirizzamento di rete.

Sintassi

PMRX_CALLDOWN MRxLowIOSubmit[LOWIO_OP_READ];

NTSTATUS MRxLowIOSubmit[LOWIO_OP_READ](
  _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_READ] restituisce STATUS_SUCCESS sull'esito positivo o su un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_FILE_CLOSED	La struttura FCB è stata acquisita, ma la struttura SRV_OPEN associata è stata chiusa.
STATUS_INSUFFICIENT_RESOURCES	Per completare la richiesta sono state eseguite risorse insufficienti.
STATUS_INVALID_DEVICE_REQUEST	È stata specificata una richiesta di dispositivo non valida.
STATUS_INVALID_PARAMETER	Un parametro non valido è stato specificato in RxContext.
STATUS_NOT_IMPLEMENTED	Questa routine non viene implementata.
STATUS_NOT_SUPPORTED	La richiesta specificata non è supportata dal mini-redirector di rete.

Commenti

RDBSS chiama MRxLowIOSubmit[LOWIO_OP_READ] in risposta alla ricezione di una richiesta di IRP_MJ_READ .

Prima di chiamare MRxLowIOSubmit[LOWIO_OP_READ], RDBSS modifica i membri seguenti nella struttura RX_CONTEXT puntati al parametro RxContext :

Il membro LowIoContext.Operation è impostato su LOWIO_OP_READ.

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

Il membro LowIoContext.ParamsFor.ReadWrite.Key è impostato sul valore di IrpSp-Parameters.Read.Key>.

Il membro ParamsFor.ReadWrite.Flags ha il bit di LOWIO_READWRITEFLAG_PAGING_IO è impostato su se Irp-Flags> ha il bit di IRP_PAGING_IO.

Il membro ParamsFor.ReadWrite.Buffer è impostato sul buffer utente bloccato per IoReadAccess.

Il membro LowIoContext.ParamsFor.ReadWrite.ByteCount è impostato sul valore di IrpSp-Parameters.Read.Length>.

Una richiesta di lettura viene normalmente implementata da un mini-reindirizzamento di rete come operazione asincrona perché può richiedere molto tempo. L'operazione in genere consiste nell'inviare una richiesta di rete al server remoto. La risposta viene ottenuta al termine della richiesta di lettura nel server. Si tratta di un esempio di operazione per cui il mini-reindirizzamento di rete potrebbe dover registrare un contesto per gestire gli annullamenti avviati in locale.

Anche se la routine MRxLowIOSubmit[LOWIO_OP_READ] viene elaborata, il membro LowIoContext.ResourceThreadId di RX_CONTEXT è garantito indicare il thread del processo che ha avviato l'operazione in RDBSS. Il membro LowIoContext.ResourceThreadId 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. La struttura FCB può essere rilasciata chiamando RxReleaseFcbResourceForThreadInMRx.