次の方法で共有

mixerGetControlDetailsW 関数 (mmeapi.h)

  • [アーティクル]

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

構文

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

パラメーター

hmxobj

クエリ対象のミキサー デバイス オブジェクトへのハンドル。

pmxcd

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

fdwDetails

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

価値 意味
MIXER_GETCONTROLDETAILSF_LISTTEXT paDetailsMIXERCONTROLDETAILS 構造体のメンバーは、複数項目コントロールのテキスト ラベルを受け取る 1 つ以上の MIXERCONTROLDETAILS_LISTTEXT 構造体を指します。 アプリケーションは、複数項目コントロールのすべてのリスト テキスト 項目を一度に取得する必要があります。 このフラグは、MIXERCONTROL_CONTROLTYPE_CUSTOM コントロールでは使用できません。
MIXER_GETCONTROLDETAILSF_VALUE コントロールの現在の値が取得されます。 paDetailsMIXERCONTROLDETAILS 構造体のメンバーは、コントロール クラスに適した 1 つ以上の詳細構造体を指します。
MIXER_OBJECTF_AUX hmxobj パラメーターは、auxGetNumDevs 関数によって返されるデバイスの数より 1 未満の 0 の範囲の補助デバイス識別子です。
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 関数によって返されるデバイスの数より 1 未満の範囲である必要があります。
MIXER_OBJECTF_MIDIOUT hmxobj パラメーターは、MIDI 出力デバイスの識別子です。 この識別子は、midiOutGetNumDevs 関数によって返されるデバイスの数より 1 未満の範囲である必要があります。
MIXER_OBJECTF_MIXER hmxobj パラメーターは、mixerGetNumDevs 関数によって返されるデバイスの数より 0 から 1 未満の範囲のミキサー デバイスの識別子です。 このフラグは省略可能です。
MIXER_OBJECTF_WAVEIN hmxobj パラメーターは、waveInGetNumDevs 関数によって返されるデバイスの数より 1 未満の 0 の範囲の波形オーディオ入力デバイスの識別子です。
MIXER_OBJECTF_WAVEOUT hmxobj パラメーターは、waveOutGetNumDevs 関数によって返されるデバイスの数より 1 未満の 0 の範囲の波形オーディオ出力デバイスの識別子です。

戻り値

成功した場合は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 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー mmeapi.h (Mmeapi.h、Windows.h を含む)
ライブラリ Winmm.lib
DLL Winmm.dll

関連項目

オーディオミキサー機能

オーディオ ミキサー