Microsoft DirectX 8.0 (C++) |
ピアまたはクライアントが利用可能なホストを列挙するとき、Microsoft® DirectPlay® は DPN_MSGID_ENUM_HOSTS_QUERY メッセージをホストのメッセージ ハンドラに送信する。
DPNMSG_ENUM_HOSTS_QUERY 構造体には、DPN_MSGID_ENUM_HOSTS_QUERY システム メッセージに関する情報が保持される。
typedef struct _DPNMSG_ENUM_HOSTS_QUERY{ DWORD dwSize; IDirectPlay8Address* pAddressSender; IDirectPlay8Address* pAddressDevice; PVOID pvReceivedData; DWORD dwReceivedDataSize; DWORD dwMaxResponseDataSize; PVOID pvResponseData; DWORD dwResponseDataSize; PVOID pvResponseContext; } DPNMSG_ENUM_HOSTS_QUERY, *PDPNMSG_ENUM_HOSTS_QUERY;
この照会に通常の応答をすると、DirectPlay はユーザーに DPN_MSGID_RETURN_BUFFER メッセージを一度送信し、バッファは不要になる。これで、バッファを安全に解放できる。
照会を拒否するには、S_OK 以外の値を返す。ただし照会を拒否すると、DirectPlay は応答を送らず、応答バッファを必要とせず、DPN_MSGID_RETURN_BUFFER メッセージを生成しない。
Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
ヘッダー : Dplay8.h で宣言。