Platform SDK: DirectX |
IDirectMusicPerformance::GetParam メソッドは、制御セグメント内のトラックからデータを取り出す。
HRESULT GetParam( REFGUID rguidType, DWORD dwGroupBits, DWORD dwIndex, MUSIC_TIME mtTime, MUSIC_TIME* pmtNext, void* pParam );
成功すれば S_OK を返す。
失敗すれば次のエラー値のいずれかを返す。
DMUS_E_GET_UNSUPPORTED |
DMUS_E_NO_MASTER_CLOCK |
DMUS_E_NOT_FOUND |
DMUS_E_TRACK_NOT_FOUND |
E_POINTER |
通常、プライマリ セグメントは制御セグメントである。ただし、セカンダリ セグメントを演奏するときは、これを制御セグメントとして指定できる。制御セグメントの詳細については、「セグメント」および「DMUS_SEGF_FLAGS」を参照すること。
別の制御セグメントが挿入される場合、*pParam で返されるデータは、*pmtNext で返されるタイムの前に無効になることがある。
各トラックは 1 つまたは複数のグループに所属するが、各グループは dwGroupBits 内のビットによって表されている。詳細については、「IDirectMusicSegment::InsertTrack」および「トラックの識別」を参照すること。
Windows NT/2000 : Windows 2000 が必要。
Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
ヘッダー : dmusici.h で宣言。
IDirectMusicPerformance::SetParam、IDirectMusicSegment::GetParam、IDirectMusicTrack::GetParam、IDirectMusicPerformance::SetGlobalParam、IDirectMusicPerformance::GetTime、ミュージック パラメータ