IDirectMusicSegment

IDirectMusicSegment::SetParam

セグメント内部のトラックにデータを設定します。

HRESULT SetParam(
    REFGUID      rguidType,
    DWORD        dwGroupBits,
    DWORD        dwIndex,
    MUSIC_TIME   mtTime,
    void*        pParam
);

メソッドのインデックス: 19

パラメータ

pDesk

設定する標準トラックパラメータを表す GUID への参照を指定します。指定できる GUID は 標準トラックパラメータ 参照。

dwGroupBits

希望のトラックが置かれているグループを指定します。すべてのグループを指定するには、 0xFFFFFFFF を指定します。

dwIndex

データをどこに設定するかを示す dwGroupBits で識別されるグループ内のトラックのインデックスを指定します。パラメータを格納するグループ内のすべてのトラックにパラメータを設定するには 0x80000000 (DMUS_SEG_ALLTRACKS) を指定します。

mtTime

データの設定を行なうタイムを指定します。

pParam

データを保持する構造体のアドレスを指定します。データが必要ない場合は 0 (NULL) を指定します。

戻り値

成功すると 0x00000000 (S_OK) が返ります。

失敗すると以下のいずれかのエラー値が返ります。

意味
0x80004003 (E_POINTER)

無効なポインタが渡されました。

0x88781123 (DMUS_E_SET_UNSUPPORTED)

指定されたパラメータの設定はサポートされていません。

0x88781166 (DMUS_E_TRACK_NOT_FOUND)

指定されたタイプのトラックがありません。