RxSetDomainForMailslotBroadcast 関数 (mrx.h)

[アーティクル]
02/26/2024

RxSetDomainForMailslotBroadcast は、ネットワークミニリダイレクタードライバーによって呼び出され、mailslot がドライバーでサポートされている場合に mailslot ブロードキャストに使用されるドメインを設定します。

構文

NTSTATUS RxSetDomainForMailslotBroadcast(
  [in] IN PUNICODE_STRING DomainName
);

パラメーター

[in] DomainName

mailslots に使用するドメインの名前を指定する、0 で終わる Unicode 文字列を含むバッファーへのポインター。

戻り値

RxSetDomainForMailslotBroadcast は、成功した場合はSTATUS_SUCCESSを返し、失敗した場合は次のいずれかのエラー値を返します。

リターンコード	説明
STATUS_INSUFFICIENT_RESOURCES	このルーチンを完了するためのリソースが不足していました。非ページプールメモリでドメイン名を格納するためのメモリ割り当て要求が失敗しました。

注釈

ドライバーがカーネルによって読み込まれるたびに、ネットワークミニリダイレクターが RDBSS に登録され、ドライバーがアンロードされるときに RDBSS で登録解除されます。この登録プロセスは、ネットワークミニリダイレクターが RDBSS からエクスポートされた登録ルーチンである RxRegisterMinirdr を呼び出すことによって読み込まれたことを RDBSS に通知する双方向ハンドシェイクです。 RDBSS は、ネットワークミニリダイレクターによってエクスポートされ、ディスパッチテーブルの一部として RxRegisterMinirdr に渡されるコールバックルーチンの 1 つである MrxStart を呼び出して、登録と初期化のプロセスを完了します。

RxRegisterMinirdr ルーチンに渡されるパラメーターの 1 つは、ネットワークミニリダイレクターが mailslot をサポートしているかどうかを示します。ネットワークミニリダイレクターは、通常、MrxStart ルーチンから RxSetDomainForMailslotBroadcast を呼び出すか、ユーザーモードのアプリケーションまたはサービスからファイルシステムコントロール (FSCTRL) または I/O コントロール (IOCTL) 要求によって開始されるドライバーを開始する外部要求の一部として呼び出します。