mixerSetControlDetails 関数 (mmeapi.h)

  • [アーティクル]

mixerSetControlDetails 関数は、オーディオ行に関連付けられた 1 つのコントロールのプロパティを設定します。

構文

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

パラメーター

hmxobj

プロパティが設定されているミキサー デバイス オブジェクトを処理します。

pmxcd

MIXERCONTROLDETAILS 構造体へのポインター。 この構造体は、コントロールの目的の状態を含むコントロール詳細構造体を参照するために使用されます。

fdwDetails

コントロールのプロパティを設定するためのフラグ。 次の値が定義されています。

値 意味
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 未満の範囲の波形オーディオ出力デバイスの識別子です。
MIXER_SETCONTROLDETAILSF_CUSTOM 指定したカスタム ミキサー コントロールのカスタム ダイアログ ボックスが表示されます。 ミキサー デバイスは、ユーザーから必要な情報を収集し、指定されたバッファー内のデータを返します。 所有ウィンドウのハンドルは、MIXERCONTROLDETAILS 構造体の hwndOwner メンバーで指定されます。 (このハンドルは NULL に設定できます)。その後、アプリケーションはダイアログ ボックスからデータを保存し、後でそれを使用して、MIXER_SETCONTROLDETAILSF_VALUE フラグを使用してコントロールを同じ状態にリセットできます。
MIXER_SETCONTROLDETAILSF_VALUE コントロールの現在の値が設定されます。 MIXERCONTROLDETAILS 構造体の paDetails メンバーは、コントロールに適したクラスの 1 つ以上のミキサーコントロール詳細構造体を指します。

戻り値

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

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

注釈

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

アプリケーションがカスタム ミキサー コントロールの現在の状態のみを取得し、ダイアログ ボックスを表示しない必要がある場合は、 mixerGetControlDetails を MIXER_GETCONTROLDETAILSF_VALUE フラグと共に使用できます。

要件

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

こちらもご覧ください

オーディオミキサー機能

オーディオ ミキサー