Platform SDK: DirectX

IDirectMusicTrack::IsParamSupported

IDirectMusicTrack::IsParamSupported メソッドは、IDirectMusicTrack::GetParamIDirectMusicTrack::SetParam の各メソッドで指定されたデータ タイプをサポートしているかどうかを判断する。

HRESULT IsParamSupported(
  REFGUID rguidType
);

パラメータ

rguidType
データ タイプの識別子への参照 (C++) またはアドレス (C)。「トラック パラメータのタイプ」を参照すること。

戻り値

メソッドが成功し、タイプがサポートされていれば S_OK、

失敗すれば次のエラー値のいずれかを返す。

DMUS_E_TYPE_DISABLED
DMUS_E_TYPE_UNSUPPORTED
E_POINTER
E_NOTIMPL

注意

SetParam メソッドのいずれかを使うことによってメッセージ タイプが無効になっている場合 (「メッセージの無効化と有効化」を参照)、IDirectMusicTrack::IsParamSupported メソッドは、対応するパラメータ タイプ (GUID_TempoParam または GUID_TimeSignature) を渡されたときに DMUS_E_TYPE_DISABLED を返す。

このメソッドは、GUID_DisableTempo を渡され、そのメッセージ タイプが既に無効になっている場合、または GUID_EnableTempo を渡され、そのメッセージ タイプが現在有効になっている場合にも、DMUS_E_TYPE_DISABLED を返す。このことは、GUID_DisableTimeSig と GUID_EnableTimeSig にも当てはまる。

GUID_EnableTempo、GUID_EnableTimeSig、GUID_DisableTempo、または GUID_DisableTimeSig の各パラメータ タイプによって参照されるメッセージ タイプをトラックがサポートしない場合、このメソッドは DMUS_E_TYPE_UNSUPPORTED を返す。

動作環境

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

参照

IDirectMusicTrack::GetParamIDirectMusicTrack::SetParamミュージック パラメータ