Microsoft DirectX 8.0 (C++)

DPN_MSGID_DESTROY_PLAYER

プレーヤーがピアツーピア セッションまたはクライアント/サーバー セッションを離れると、Microsoft® DirectPlay® により DPN_MSGID_DESTROY_PLAYER メッセージが生成される。

DPNMSG_DESTROY_PLAYER

DPNMSG_DESTROY_PLAYER 構造体には、DPN_MSGID_DESTROY_PLAYER システム メッセージに関する情報が保持される。

typedef struct _DPNMSG_DESTROY_PLAYER{
    DWORD  dwSize;
    DPNID  dpnidPlayer;
    PVOID  pvPlayerContext;
    DWORD  dwReason;
} DPNMSG_DESTROY_PLAYER, *PDPNMSG_DESTROY_PLAYER;
dwSize
この構造体のサイズ。
dpnidPlayer
セッションから削除されるプレーヤーの DPNID。
pvPlayerContext
プレーヤーのコンテキスト値。
dwReason
プレーヤーが破棄された理由を示す次のいずれかのフラグ。
DPNDESTROYPLAYERREASON_NORMAL
プレーヤーは通常の理由で削除される。
DPNDESTROYPLAYERREASON_CONNECTIONLOST
接続が失われたため、プレーヤーは削除される。
DPNDESTROYPLAYERREASON_SESSIONTERMINATED
セッションが終了したため、プレーヤーは削除される。
DPNDESTROYPLAYERREASON_HOSTDESTROYEDPLAYER
ホストが IDirectPlay8Peer::DestroyPeer を呼び出したため、プレーヤーは削除される。

注意

クライアント/サーバー モードでは、サーバーだけがこのメッセージを受け取る。ピアツーピア モードでは、すべてのプレーヤーがこのメッセージを受け取る。

異なる複数のスレッドで DPN_MSGID_CREATE_PLAYER メッセージと DPN_MSGID_DESTROY_PLAYER メッセージを受け取ることがある。しかし、コールバック関数が DPN_MSGID_CREATE_PLAYER メッセージの受信から戻る前に DPN_MSGID_DESTROY_PLAYER メッセージを受け取ることはない。

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : Dplay8.h で宣言。