mixerGetControlDetailsA 関数 (mmeapi.h)

  • [アーティクル]

mixerGetControlDetails 関数は、オーディオ行に関連付けられている 1 つのコントロールに関する詳細を取得します。

構文

MMRESULT mixerGetControlDetailsA(
  HMIXEROBJ             hmxobj,
  LPMIXERCONTROLDETAILS pmxcd,
  DWORD                 fdwDetails
);

パラメーター

hmxobj

クエリ対象のミキサー デバイス オブジェクトを処理します。

pmxcd

コントロールに関する状態情報が入力された MIXERCONTROLDETAILS 構造体へのポインター。

fdwDetails

コントロールの詳細を取得するためのフラグ。 次の値が定義されています。

値 説明
MIXER_GETCONTROLDETAILSF_LISTTEXT MIXERCONTROLDETAILS 構造体の paDetails メンバーは、1 つ以上のMIXERCONTROLDETAILS_LISTTEXT構造体を指し、複数項目コントロールのテキスト ラベルを受け取ります。 アプリケーションは、複数項目コントロールのすべてのリスト テキスト アイテムを一度に取得する必要があります。 このフラグは、MIXERCONTROL_CONTROLTYPE_CUSTOM コントロールでは使用できません。
MIXER_GETCONTROLDETAILSF_VALUE コントロールの現在の値が取得されます。 MIXERCONTROLDETAILS 構造体の paDetails メンバーは、コントロール クラスに適した 1 つ以上の詳細構造体を指します。
MIXER_OBJECTF_AUX hmxobj パラメーターは、auxGetNumDevs 関数によって返されるデバイスの数より 0 から 1 未満の範囲の補助デバイス識別子です。
MIXER_OBJECTF_HMIDIIN hmxobj パラメーターは、MIDI (楽器デジタル インターフェイス) 入力デバイスのハンドルです。 このハンドルは 、midiInOpen 関数によって返されている必要があります。
MIXER_OBJECTF_HMIDIOUT hmxobj パラメーターは、MIDI 出力デバイスのハンドルです。 このハンドルは 、midiOutOpen 関数によって返されている必要があります。
MIXER_OBJECTF_HMIXER hmxobj パラメーターは、mixerOpen 関数によって返されるミキサー デバイス ハンドルです。 このフラグは省略可能です。
MIXER_OBJECTF_HWAVEIN hmxobj パラメーターは、waveInOpen 関数によって返される波形オーディオ入力ハンドルです。
MIXER_OBJECTF_HWAVEOUT hmxobj パラメーターは、waveOutOpen 関数によって返される波形オーディオ出力ハンドルです。
MIXER_OBJECTF_MIDIIN hmxobj パラメーターは、MIDI 入力デバイスの識別子です。 この識別子は、 midiInGetNumDevs 関数によって返されるデバイスの数より 0 から 1 未満の範囲である必要があります。
MIXER_OBJECTF_MIDIOUT hmxobj パラメーターは、MIDI 出力デバイスの識別子です。 この識別子は、 midiOutGetNumDevs 関数によって返されるデバイスの数よりも 0 から 1 未満の範囲である必要があります。
MIXER_OBJECTF_MIXER hmxobj パラメーターは、mixerGetNumDevs 関数によって返されるデバイスの数より 0 から 1 未満の範囲のミキサー デバイスの識別子です。 このフラグは省略可能です。
MIXER_OBJECTF_WAVEIN hmxobj パラメーターは、waveInGetNumDevs 関数によって返されるデバイスの数より 0 から 1 未満の範囲の波形オーディオ入力デバイスの識別子です。
MIXER_OBJECTF_WAVEOUT hmxobj パラメーターは、waveOutGetNumDevs 関数によって返されるデバイスの数より 0 から 1 未満の範囲の波形オーディオ出力デバイスの識別子です。

戻り値

成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。

リターン コード 説明
MIXERR_INVALCONTROL
 コントロール参照が無効です。
MMSYSERR_BADDEVICEID
 hmxobj パラメーターは、無効なデバイス識別子を指定します。
MMSYSERR_INVALFLAG
 1 つ以上のフラグが無効です。
MMSYSERR_INVALHANDLE
 hmxobj パラメーターは無効なハンドルを指定します。
MMSYSERR_INVALPARAM
 1 つ以上のパラメーターが無効です。
MMSYSERR_NODRIVER
 hmxobj で指定されたオブジェクトに対してミキサー デバイスを使用できません。

解説

この関数を呼び出す前に 、MIXERCONTROLDETAILS 構造体のすべてのメンバーを初期化する必要があります。

注意

mmeapi.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして mixerGetControlDetails を定義します。 エンコードに依存しないエイリアスをエンコードニュートラルでないコードと組み合わせて使用すると、コンパイルまたはランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「 関数プロトタイプの規則」を参照してください。

要件

   
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows 2000 Server [デスクトップ アプリのみ]
対象プラットフォーム Windows
ヘッダー mmeapi.h (Mmeapi.h、Windows.h を含む)
Library Winmm.lib
[DLL] Winmm.dll

関連項目

オーディオミキサー機能

オーディオ ミキサー