RxSetDomainForMailslotBroadcast function

RxSetDomainForMailslotBroadcast is called by a network mini-redirector driver to set the domain used for mailslot broadcasts if mailslots are supported by the driver.

Syntax


NTSTATUS RxSetDomainForMailslotBroadcast(
  _In_ PUNICODE_STRING DomainName
);

Parameters

DomainName [in]

A pointer to a buffer that contains a zero-terminated Unicode string that names the domain to use for mailslots.

Return value

RxSetDomainForMailslotBroadcast returns STATUS_SUCCESS on success or one of the following error values on failure:

Return codeDescription
STATUS_INSUFFICIENT_RESOURCES

There were insufficient resources to complete this routine. The memory allocation request failed for nonpaged pool memory to store the domain name.

 

Remarks

A network mini-redirector registers with RDBSS whenever the driver is loaded by the kernel and unregisters with RDBSS when the driver is unloaded. This registration process is a two-way hand shake in which the network mini-redirector informs RDBSS that it has been loaded by calling RxRegisterMinirdr, the registration routine exported from RDBSS. RDBSS completes the registration and initialization process by calling MrxStart, one of the callback routines exported by the network mini-redirector and passed in as part of the dispatch table to RxRegisterMinirdr.

One of the parameters passed to the RxRegisterMinirdr routine indicates whether the network mini-redirector supports mailslots. A network mini-redirector would normally call RxSetDomainForMailslotBroadcast from the MrxStart routine or as part of an external request to start the driver initiated by a file system control (FSCTRL) or an I/O control (IOCTL) request from a user-mode application or service.

Requirements

Target platform

Header

Mrx.h (include Mrx.h)

IRQL

<= APC_LEVEL

See also

IoCreateDevice
RxRegisterMinirdr
RxStartMinirdr
RxStopMinirdr
__RxFillAndInstallFastIoDispatch

 

 

Send comments about this topic to Microsoft

Show: