RxSetDomainForMailslotBroadcast, fonction (mrx.h)

Article
02/07/2025

RxSetDomainForMailslotBroadcast est appelée par un pilote de mini-redirecteur réseau pour définir le domaine utilisé pour les diffusions de maillots si les messageslots sont pris en charge par le pilote.

Syntaxe

NTSTATUS RxSetDomainForMailslotBroadcast(
  [in] IN PUNICODE_STRING DomainName
);

Paramètres

[in] DomainName

Pointeur vers une mémoire tampon qui contient une chaîne Unicode sans fin qui nomme le domaine à utiliser pour les mailslots.

Valeur de retour

RxSetDomainForMailslotBroadcast retourne STATUS_SUCCESS en cas de réussite ou l’une des valeurs d’erreur suivantes en cas d’échec :

Retourner le code	Description
STATUS_INSUFFICIENT_RESOURCES	Il y avait des ressources insuffisantes pour effectuer cette routine. La demande d’allocation de mémoire a échoué pour que la mémoire du pool non paginé stocke le nom de domaine.

Remarques

Un mini-redirecteur réseau s’inscrit auprès de RDBSS chaque fois que le pilote est chargé par le noyau et annule l’inscription auprès de RDBSS lorsque le pilote est déchargé. Ce processus d’inscription est un shake bidirectionnel dans lequel le mini-redirecteur réseau informe RDBSS qu’il a été chargé en appelant RxRegisterMinirdr, la routine d’inscription exportée à partir de RDBSS. RDBSS termine le processus d’inscription et d’initialisation en appelant MrxStart, l’une des routines de rappel exportées par le mini-redirecteur réseau et transmises dans le cadre de la table de distribution à RxRegisterMinirdr.

L’un des paramètres passés à la routine RxRegisterMinirdr indique si le mini-redirecteur réseau prend en charge les mailslots. Un mini-redirecteur réseau appelle normalement RxSetDomainForMailslotBroadcast à partir de la routine MrxStart ou dans le cadre d’une demande externe pour démarrer le pilote initié par un contrôle de système de fichiers (FSCTRL) ou une demande de contrôle d’E/S (IOCTL) à partir d’une application ou d’un service en mode utilisateur.