PMRX_CALLDOWN_CTX Rückruffunktion (mrx.h)

Die MRxStart-Routine wird von RDBSS aufgerufen, um den Netzwerk-Mini-Redirector zu starten.

Syntax

PMRX_CALLDOWN_CTX PmrxCalldownCtx;

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

Parameter

[in, out] RxContext

Ein Zeiger auf die RX_CONTEXT-Struktur. Dieser Parameter enthält die IRP, die den Start des Netzwerkminiumleitungs-Umleitungscomputers angefordert hat.

[in, out] RxDeviceObject

Ein Zeiger auf die RDBSS_DEVICE_OBJECT-Struktur für diesen Netzwerk-Miniumleitungsor.

Rückgabewert

MRxStart gibt STATUS_SUCCESS nach Erfolg oder einen geeigneten NTSTATUS-Wert zurück, z. B. einen der folgenden:

Rückgabecode	Beschreibung
STATUS_REDIRECTOR_STARTED	Der Netzwerk-Mini-Redirector wurde bereits gestartet.
STATUS_UNSUCCESSFUL	Der Netzwerk-Miniumleitung konnte nicht erfolgreich gestartet werden.

Hinweise

MRxStart schließt die Initialisierung des Netzwerkmini-Redirectors aus RDBSS-Perspektive ab. Beachten Sie, dass sich dies von der Initialisierung in der DriverEntry-Routine unterscheidet. Jede von RDBSS abhängige Initialisierung sollte im Rahmen dieser Routine durchgeführt werden, während die von RDBSS unabhängige Initialisierung in der DriverEntry-Routine erfolgen sollte.

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

Der MajorFunction-Member ist auf die Hauptfunktion des IRP festgelegt.

Der LowIoContext.ParamsFor.FsCtl.FsControlCode-Member wird auf den FSCTL-Code für das IRP festgelegt, wenn dies eine FSTCL-Anforderung war, die zum Starten des Netzwerkminiumleitungsmoduls verwendet wurde.

MRxStart wird von RDBSS aus der RxStartMinirdr-Routine aufgerufen. Vor dem Aufruf von MRxStart registriert RDBSS RxDeviceObject des Netzwerk-Mini-Redirectors als Dateisystem. RDBSS registriert auch den Netzwerkminiumleitungsor als UNC-Anbieter, wenn der Netzwerkminiumleitungsor die Unterstützung für UNC-Namen angibt.

Wenn MRxStart STATUS_SUCCESS zurückgibt, war die Routine erfolgreich. Jeder andere Rückgabewert gibt an, dass in der Startsequenz ein Fehler aufgetreten ist.

Wenn MRxStart STATUS_SUCCESS zurückgibt, legt RDBSS den Zustand von RDBSS auf RDBSS_STARTED fest. Dieser Zustand wird im StartStopContext.State-Element der RDBSS_DEVICE_OBJECT-Struktur gespeichert, auf die RxDeviceObject verweist.

Ein Netzwerk-Mini-Redirector verwaltet normalerweise eine interne Variable, die angibt, ob der Netzwerkminiumleitungsor gestartet wird. Beispielsweise kann ein Netzwerkminiumleitungs-Redirector nachverfolgen, wann er beendet, gestartet wird und wann ein Start- oder Beendigungsvorgang ausgeführt wird.

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	mrx.h (mrx.h einschließen)

Weitere Informationen

MRxDevFcbXXXControlFile

MRxStop

RxStartMinirdr