mixerGetLineControlsA 関数 (mmeapi.h)

  • [アーティクル]

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

構文

MMRESULT mixerGetLineControlsA(
  HMIXEROBJ            hmxobj,
  LPMIXERLINECONTROLSA pmxlc,
  DWORD                fdwControls
);

パラメーター

hmxobj

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

pmxlc

MIXERLINECONTROLS 構造体へのポインター。 この構造体は、オーディオラインに関連付けられているコントロールに関する情報を入力する 1 つ以上の MIXERCONTROL 構造体を参照するために使用されます。 MIXERLINECONTROLS 構造体の cbStruct メンバーは、 MIXERLINECONTROLS 構造体のサイズ (バイト単位) に 常に初期化 する必要があります。

fdwControls

オーディオラインに関連付けられている 1 つ以上のコントロールに関する情報を取得するためのフラグ。 次の値が定義されています。

値 意味
MIXER_GETLINECONTROLSF_ALL pmxlc パラメーターは、MIXERLINECONTROLS 構造体の dwLineID メンバーによって識別されるオーディオ行に関連付けられているすべてのコントロールに関する情報を受け取る MIXERCONTROL 構造体のリストを参照します。 cControls メンバーは、行に関連付けられているコントロールの数に初期化する必要があります。 この数値は、mixerGetLineInfo 関数によって返される MIXERLINE 構造体の cControls メンバーから取得されます。 cbmxctrl メンバーは、1 つの MIXERCONTROL 構造体のサイズ (バイト単位) に初期化する必要があります。 pamxctrl メンバーは、入力する最初の MIXERCONTROL 構造体を指す必要があります。 このクエリでは 、dwControlID メンバーと dwControlType メンバーは無視されます。
MIXER_GETLINECONTROLSF_ONEBYID pmxlc パラメーターは、MIXERLINECONTROLS 構造体の dwControlID メンバーによって識別されるコントロールに関する情報を受け取る 1 つの MIXERCONTROL 構造体を参照します。 cControls メンバーは 1 に初期化する必要があります。 cbmxctrl メンバーは、1 つの MIXERCONTROL 構造体のサイズ (バイト単位) に初期化する必要があります。 pamxctrl メンバーは、塗りつぶす MIXERCONTROL 構造体を指す必要があります。 このクエリでは 、dwLineID メンバーと dwControlType メンバーは無視されます。 このクエリは通常、ユーザー定義コールバックによって MM_MIXM_CONTROL_CHANGE コントロール変更通知メッセージを受信した後にコントロールを更新するために使用されます ( 「mixerOpen」を参照)。
MIXER_GETLINECONTROLSF_ONEBYTYPE mixerGetLineControls 関数は、クエリ対象のオーディオ行の特定のクラスの最初のコントロールに関する情報を取得します。 pmxlc パラメーターは、特定のコントロールに関する情報を受け取る 1 つの MIXERCONTROL 構造体を参照します。 オーディオ行は dwLineID メンバーによって識別されます。 コントロール クラスは、MIXERLINECONTROLS 構造体の dwControlType メンバーで指定されます。このクエリでは、dwControlID メンバーは無視されます。 このクエリは、アプリケーションが行に関連付けられている 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
 コントロール参照が無効です。
MIXERR_INVALLINE
 オーディオ行参照が無効です。
MMSYSERR_BADDEVICEID
 hmxobj パラメーターは、無効なデバイス識別子を指定します。
MMSYSERR_INVALFLAG
 1 つ以上のフラグが無効です。
MMSYSERR_INVALHANDLE
 hmxobj パラメーターは無効なハンドルを指定します。
MMSYSERR_INVALPARAM
 1 つ以上のパラメーターが無効です。
MMSYSERR_NODRIVER
 hmxobj で指定されたオブジェクトに対してミキサー デバイスを使用できません。

注釈

注意

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

要件

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

こちらもご覧ください

オーディオ ミキサー関数

オーディオ ミキサー