RxSetDomainForMailslotBroadcast-Funktion (mrx.h)

Artikel
02/07/2025

RxSetDomainForMailslotBroadcast wird von einem Netzwerk-Miniumleitungstreiber aufgerufen, um die Domäne festzulegen, die für Maillot-Übertragungen verwendet wird, wenn E-Maillots vom Treiber unterstützt werden.

Syntax

NTSTATUS RxSetDomainForMailslotBroadcast(
  [in] IN PUNICODE_STRING DomainName
);

Parameter

[in] DomainName

Ein Zeiger auf einen Puffer, der eine mit Null beendete Unicode-Zeichenfolge enthält, die die Domäne benennt, die für Maillots verwendet werden soll.

Rückgabewert

RxSetDomainForMailslotBroadcast gibt STATUS_SUCCESS bei Erfolg oder einen der folgenden Fehlerwerte für Fehler zurück:

Rückgabecode	Beschreibung
STATUS_INSUFFICIENT_RESOURCES	Es gab nicht genügend Ressourcen, um diese Routine abzuschließen. Fehler bei der Speicherzuweisungsanforderung für nicht seitenseitigen Poolspeicher zum Speichern des Domänennamens.

Bemerkungen

Ein Netzwerk-Miniumleitungsmodul registriert sich bei RDBSS, wenn der Treiber vom Kernel geladen wird, und hebt die Registrierung mit RDBSS auf, wenn der Treiber entladen wird. Dieser Registrierungsprozess ist ein bidirektionales Schütteln, in dem der Netzwerk-Miniumleitungsmodul RDBSS darüber informiert, dass er geladen wurde, indem er RxRegisterMinirdraufruft, die Registrierungsroutine, die aus RDBSS exportiert wurde. RDBSS schließt den Registrierungs- und Initialisierungsprozess ab, indem MrxStartaufgerufen wird, eine der Rückrufroutinen, die vom Netzwerk-Miniumleitungsmodul exportiert und als Teil der Verteilertabelle an RxRegisterMinirdrübergeben werden.

Einer der Parameter, die an die RxRegisterMinirdr Routine übergeben werden, gibt an, ob der Netzwerk-Miniumleitungs-Redirector Mailslots unterstützt. Ein Netzwerk-Miniumleitungsmodul würde normalerweise RxSetDomainForMailslotBroadcast aus der MrxStart Routine oder als Teil einer externen Anforderung aufrufen, um den Treiber zu starten, der von einer Dateisystemsteuerung (FSCTRL) oder einer I/O-Steuerelementanforderung (IOCTL) von einer Benutzermodusanwendung oder einem Dienst initiiert wird.