Platform SDK: DirectX

DPLMSG_GETPROPERTYRESPONSE

DPLMSG_GETPROPERTYRESPONSE メッセージは、ロビーにより、DPLMSG_GETPROPERTY メッセージへの応答としてアプリケーションに送信される。要求が満たされた場合、その要求は dwRequestID メンバにより識別される。

typedef struct {
    DWORD    dwType;
    DWORD    dwRequestID
    GUID     guidPlayer;
    GUID     guidPropertyTag;
    HRESULT  hr;
    DWORD    dwDataSize;
    DWORD    dwPropertyData[1];
} DPLMSG_GETPROPERTYRESPONSE, FAR *LPDPLMSG_GETPROPERTYRESPONSE;
dwType
メッセージを識別する。この値は、DPLSYS_ GETPROPERTYRESPONSE である。
dwRequestID
このメッセージの応答先の DPLMSG_GETPROPERTY メッセージを識別する ID。
guidPlayer
このプロパティが適用される (適用可能な場合) プレーヤーを識別する GUID。プロパティがプレーヤーに固有でない場合、このメンバには GUID_NULL が設定される。これは、DPLMSG_GETPROPERTY メッセージの GUID と同じである。
guidPropertyTag
要求されたプロパティを識別する GUID。これは、DPLMSG_GETPROPERTY メッセージの GUID と同じである。
hr
プロパティ取得要求の戻りコード。次の値のいずれかである。
DP_OK
プロパティは正常に返された。
DPERR_UNKNOWNMESSAGE
要求されたプロパティは、ロビーでは確認されていない。
DPERR_UNAVAILABLE
要求されたプロパティは、使用不可能な状態である。
dwDataSize
プロパティ データのサイズ (バイト単位)。
dwPropertyData
プロパティ データが格納されている可変サイズのバッファ。プロパティ タグは、このデータの解釈方法を定義している。

注意

ロビーは、すべての DPLMSG_GETPROPERTY 要求に応答するか、またはまったく応答しない。

このメッセージを構成するとき、ロビーは DPLMSG_GETPROPERTYRESPONSE 構造体と完全なプロパティ データを保持するのに十分なメモリを割り当てる必要がある。たとえば、プロパティ データで 52 バイトが必要な場合、ロビーは (sizeof(DPLMSG_GETPROPERTYRESPONSE) + 52) バイトを割り当て、それを DPLMSG_GETPROPERTYRESPONSE ポインタに割り当てる。

必要条件

  Windows NT/2000 : Windows 2000 が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : Dplobby.h で宣言。

参照

DPLMSG_GETPROPERTY