RxSetDomainForMailslotBroadcast 関数 (mrx.h)
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) 要求によって開始されるドライバーを開始する外部要求の一部として呼び出します。
要件
| 要件 | 値 |
|---|---|
| 対象プラットフォーム | デスクトップ |
| Header | mrx.h (Mrx.h を含む) |
| IRQL | <= APC_LEVEL |