次の方法で共有

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 パラメーターは、MIXERCONTROL 構造体の一覧を参照します。この構造体は、MIXERLINECONTROLS 構造体の dwLineID メンバーによって識別されるオーディオ行に関連付けられているすべてのコントロールに関する情報を受け取ります。 cControls メンバーは、行に関連付けられているコントロールの数に初期化する必要があります。 この数値は、mixerGetLineInfo 関数によって返される MIXERLINE 構造体の cControls メンバーから取得されます。 cbmxctrl メンバーは、1 つの MIXERCONTROL 構造体のサイズ (バイト単位) に初期化する必要があります。 pamxctrl メンバーは、フィルする最初の MIXERCONTROL 構造体を指す必要があります。 dwControlID および dwControlType メンバー は、このクエリでは無視されます。
MIXER_GETLINECONTROLSF_ONEBYID pmxlc パラメーターは、MIXERLINECONTROLS 構造体の dwControlID メンバーによって識別されるコントロールに関する情報を受け取る単一の 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 関数によって返されるデバイスの数より 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
 コントロール参照が無効です。
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 [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー mmeapi.h (Windows.h を含む)
ライブラリ Winmm.lib
DLL Winmm.dll

関連項目

オーディオミキサー機能

オーディオ ミキサー