Platform SDK: DirectX |
IDirectPlay4::SendChatMessage メソッドは、テキスト メッセージを別のプレーヤー、プレーヤーのグループ、またはすべてのプレーヤーに送信する。このメソッドは、Unicode 文字列 (IDirectPlay4 インターフェイス) と ANSI 文字列 (IDirectPlay4A インターフェイス) を両方ともサポートしている。チャット メッセージを受信したプレーヤーには、プレーヤーの受信キューの DPMSG_CHAT システム メッセージにより通知がある。このメソッドは、ロビー セッションで使用される。
HRESULT SendChatMessage( DPID idFrom, DPID idTo, DWORD dwFlags, LPDPCHAT lpChatMessage );
成功すれば DP_OK、失敗すれば次のエラー値のいずれかを返す。
DPERR_ACCESSDENIED |
DPERR_CONNECTIONLOST |
DPERR_INVALIDFLAGS |
DPERR_INVALIDPARAMS |
DPERR_INVALIDPLAYER |
idTo の ID が有効なプレーヤーまたはグループでない場合は、DPERR_INVALIDPARAMS を返す。idFrom の ID が有効なプレーヤーまたはグループでない場合は、DPERR_INVALIDPLAYER を返す。idFrom の ID がローカル プレーヤーでない場合は、DPERR_ACCESSDENIED を返す。
このメソッドは、異なるクライアント アプリケーションを接続可能なロビー セッション内でのプレーヤー間のチャットを容易にする。このメソッドは、ロビー セッションで使用する。アプリケーション セッションでの使用は、オプションである。
受信側プレーヤーは、システム メッセージ (idFrom = DPID_SYSMSG) を受信する。DPCHAT 構造体は、チャット メッセージの送信元プレーヤーを指定する。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dplay.h で宣言。
インポート ライブラリ : dplayx.lib を使用。