次の方法で共有

DPN_MSGID_ENUM_HOSTS_QUERY メッセージ

  • [アーティクル]

DPN_MSGID_ENUM_HOSTS_QUERY メッセージ

ピアまたはクライアントが利用可能なホストを列挙すると、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;

メンバ

  • dwSize
    この構造体のサイズ。
  • pAddressSender
    送信者のアドレスを指定する IDirectPlay8Address インターフェイスへのポインタ。IDirectPlay8Address::AddRef を呼び出して、インターフェイスの参照カウントをインクリメントする必要がある。インターフェイスが不要になったときは、IDirectPlay8Address::Release を呼び出す。
  • pAddressDevice
    デバイスのアドレスを指定する IDirectPlay8Address インターフェイスへのポインタ。IDirectPlay8Address::AddRef を呼び出して、インターフェイスの参照カウントをインクリメントする必要がある。インターフェイスが不要になったときは、IDirectPlay8Address::Release を呼び出す。
  • pvReceivedData
    列挙から受け取るデータへのポインタ。
  • dwReceivedDataSize
    pvReceivedData メンバが示すデータ サイズ。
  • dwMaxResponseDataSize
    許可される列挙応答の最大サイズ。
  • pvResponseData
    列挙からの応答データへのポインタ。このデータは、コールバック メッセージ ハンドラとは無関係に有効でなければならない。スタック ベースは使うことができない。DirectPlay がこのバッファの処理を終了すると、DPN_MSGID_RETURN_BUFFER メッセージを受信する。
  • dwResponseDataSize
    pvResponseData メンバが示すデータ サイズ。
  • pvResponseContext
    応答コンテキスト値へのポインタ。この値は、関連する構造体の pvUserContext メンバとして、DPN_MSGID_RETURN_BUFFER メッセージと共にホストのメッセージ ハンドラに渡される。

注意

DPN_OK が含まれた、メッセージ コールバック関数からの戻り値。

この問い合わせに通常の応答をすると、バッファが不要になったときに DirectPlay はユーザーに DPN_MSGID_RETURN_BUFFER メッセージを送信する。これで、バッファを安全に解放できる。

問い合わせを拒否するには、DPN_OK 以外の値を返す。ただし、問い合わせを拒否すると、DirectPlay は応答を送信しない。また、応答バッファを必要とせず、DPN_MSGID_RETURN_BUFFER メッセージも生成しない。

メッセージの情報

ヘッダー dplay8.h
最低限のオペレーティング システム Windows 98、Pocket PC 2002