Función RxSetDomainForMailslotBroadcast (mrx.h)

Artículo
02/29/2024

Un controlador minidirector de red llama a RxSetDomainForMailslotBroadcast para establecer el dominio usado para las difusión de mailslot si el controlador admite mailslots.

Sintaxis

NTSTATUS RxSetDomainForMailslotBroadcast(
  [in] IN PUNICODE_STRING DomainName
);

Parámetros

[in] DomainName

Puntero a un búfer que contiene una cadena Unicode terminada en cero que asigna un nombre al dominio que se va a usar para los gráficos de correo.

Valor devuelto

RxSetDomainForMailslotBroadcast devuelve STATUS_SUCCESS si se ejecuta correctamente o uno de los siguientes valores de error en caso de error:

Código devuelto	Descripción
STATUS_INSUFFICIENT_RESOURCES	No había recursos suficientes para completar esta rutina. Error en la solicitud de asignación de memoria para que la memoria del grupo no paginada almacene el nombre de dominio.

Comentarios

Un minidirector de red se registra con RDBSS cada vez que el kernel carga el controlador y anula el registro con RDBSS cuando se descarga el controlador. Este proceso de registro es un agitado bidireccional en el que el minidirector de red informa a RDBSS de que se ha cargado llamando a RxRegisterMinirdr, la rutina de registro exportada desde RDBSS. RDBSS completa el proceso de registro e inicialización llamando a MrxStart, una de las rutinas de devolución de llamada exportadas por el minidirector de red y pasadas como parte de la tabla de distribución a RxRegisterMinirdr.

Uno de los parámetros pasados a la rutina RxRegisterMinirdr indica si el minidirector de red admite mailslots. Normalmente, un minidirector de red llamaría a RxSetDomainForMailslotBroadcast desde la rutina MrxStart o como parte de una solicitud externa para iniciar el controlador iniciado por un control del sistema de archivos (FSCTRL) o una solicitud de control de E/S (IOCTL) desde una aplicación o servicio en modo de usuario.