PMRX_CALLDOWN_CTX funzione di callback (mrx.h)

La routine MRxStart viene chiamata da RDBSS per avviare il mini-reindirizzamento di rete.

Sintassi

PMRX_CALLDOWN_CTX PmrxCalldownCtx;

NTSTATUS PmrxCalldownCtx(
  [in, out] IN OUT PRX_CONTEXT RxContext,
  [in, out] IN OUT PRDBSS_DEVICE_OBJECT RxDeviceObject
)
{...}

Parametri

[in, out] RxContext

Puntatore alla struttura RX_CONTEXT. Questo parametro contiene l'IRP che ha richiesto l'avvio del mini-reindirizzamento di rete.

[in, out] RxDeviceObject

Puntatore alla struttura RDBSS_DEVICE_OBJECT per questo mini-reindirizzamento di rete.

Valore restituito

MRxStart restituisce STATUS_SUCCESS in caso di esito positivo o di un valore NTSTATUS appropriato, ad esempio uno dei seguenti:

Codice restituito	Descrizione
STATUS_REDIRECTOR_STARTED	Il mini-reindirizzamento della rete è già stato avviato.
STATUS_UNSUCCESSFUL	Il mini-reindirizzamento di rete non è stato in grado di avviare correttamente.

Commenti

MRxStart completa l'inizializzazione del mini-reindirizzamento di rete dal punto di vista RDBSS. Si noti che questa operazione è diversa dall'inizializzazione eseguita nella routine DriverEntry . Qualsiasi inizializzazione che dipende da RDBSS deve essere eseguita come parte di questa routine mentre l'inizializzazione indipendente da RDBSS deve essere eseguita nella routine DriverEntry .

Prima di chiamare MRxStart, RDBSS modifica i membri seguenti nella struttura RX_CONTEXT a cui punta il parametro RxContext :

Il membro MajorFunction è impostato sulla funzione principale dell'IRP.

Il membro LowIoContext.ParamsFor.FsCtl.FsControlCode è impostato sul codice FSCTL per l'IRP se si tratta di una richiesta FSTCL usata per avviare il mini-reindirizzamento di rete.

MRxStart viene chiamato da RDBSS dalla routine RxStartMinirdr . Prima di chiamare MRxStart, RDBSS registra RxDeviceObject del mini-redirector di rete come file system. RDBSS registrerà anche il mini-reindirizzamento di rete come provider UNC se il mini-reindirizzamento di rete indica il supporto per i nomi UNC.

Se MRxStart restituisce STATUS_SUCCESS, la routine è riuscita. Qualsiasi altro valore restituito indica che si è verificato un errore nella sequenza di avvio.

Se MRxStart restituisce STATUS_SUCCESS, RDBSS imposta lo stato di RDBSS su RDBSS_STARTED. Questo stato viene archiviato nel membro StartStopContext.State della struttura RDBSS_DEVICE_OBJECT a cui punta RxDeviceObject.

Un mini-reindirizzamento di rete normalmente mantiene una variabile interna che indica se viene avviato il mini-reindirizzamento di rete. Ad esempio, un mini-reindirizzamento di rete potrebbe tenere traccia di quando viene arrestato, avviato e quando un'operazione di avvio o arresto è in corso.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Desktop
Intestazione	mrx.h (include Mrx.h)

Vedi anche

MRxDevFcbXXXControlFile

MRxStop

RxStartMinirdr