Microsoft DirectX 8.0 (C++)

IDirectMusicTrack8::IsParamSupported

IDirectMusicTrack8::GetParam メソッドと IDirectMusicTrack8::SetParam メソッドで指定されたデータ型をサポートしているかどうかを判断する。

HRESULT IsParamSupported(
  REFGUID rguidType
);

パラメータ

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

戻り値

メソッドが成功し、タイプがサポートされている場合は S_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

DMUS_E_TYPE_DISABLED
DMUS_E_TYPE_UNSUPPORTED
E_POINTER
E_NOTIMPL

注意

SetParam メソッドのいずれかを使うことによってパラメータが無効になっている場合、IDirectMusicTrack8::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 を返す。

動作環境

  ヘッダー : dmplugin.h で宣言。

参照

IDirectMusicTrack8::GetParamIDirectMusicTrack8::SetParamパフォーマンス パラメータ