mixerGetLineInfoA 関数 (mmeapi.h)

  • [アーティクル]

mixerGetLineInfo 関数は、ミキサー デバイスの特定の行に関する情報を取得します。

構文

MMRESULT mixerGetLineInfoA(
  HMIXEROBJ    hmxobj,
  LPMIXERLINEA pmxl,
  DWORD        fdwInfo
);

パラメーター

hmxobj

特定のオーディオ行を制御するミキサー デバイス オブジェクトを処理します。

pmxl

MIXERLINE 構造体へのポインター。 この構造には、ミキサーデバイスのオーディオラインに関する情報が入力されています。 cbStruct メンバーは、常に MIXERLINE 構造体のサイズ (バイト単位) に初期化する必要があります。

fdwInfo

オーディオラインに関する情報を取得するためのフラグ。 次の値が定義されています。

値 説明
MIXER_GETLINEINFOF_COMPONENTTYPE pmxl パラメーターは、MIXERLINE 構造体の dwComponentType メンバーで指定された型の最初のオーディオ行に関する情報を受け取ります。 このフラグは、特定のコンポーネントの種類のオーディオ行に関する情報を取得するために使用されます。 cbStruct を除く残りの構造体メンバーは、それ以上初期化する必要はありません。
MIXER_GETLINEINFOF_DESTINATION pmxl パラメーターは、MIXERLINE 構造体の dwDestination メンバーによって指定された宛先オーディオ行に関する情報を受け取ります。 このインデックスの範囲は、MIXERCAPS 構造体の cDestinations メンバーの値より 0 から 1 未満です。 cbStruct を除く残りの構造体メンバーはすべて、それ以上初期化する必要はありません。
MIXER_GETLINEINFOF_LINEID pmxl パラメーターは、MIXERLINE 構造体の dwLineID メンバーによって指定されたオーディオ行に関する情報を受け取ります。 これは通常、オーディオラインの状態に関する更新された情報を取得するために使用されます。 cbStruct を除く残りの構造体メンバーはすべて、それ以上初期化する必要はありません。
MIXER_GETLINEINFOF_SOURCE pmxl パラメーターは、MIXERLINE 構造体の dwDestination メンバーと dwSource メンバーによって指定されたソース オーディオラインに関する情報を受け取ります。 dwDestination で指定されたインデックスの範囲は、MIXERCAPS 構造体の cDestinations メンバーの値より 0 から 1 未満です。 dwSource で指定されたインデックスの範囲は、dwDestination メンバーに格納されているオーディオ行に対して返される MIXERLINE 構造体の cConnections メンバーの値より 0 から 1 未満です。 cbStruct を除く残りの構造体メンバーはすべて、それ以上初期化する必要はありません。
MIXER_GETLINEINFOF_TARGETTYPE pmxl パラメーターは、MIXERLINE 構造体のメンバーである Target 構造体の dwType メンバーに対するオーディオ行に関する情報を受け取ります。 このフラグは、ターゲットの種類 ( たとえば、MIXERLINE_TARGETTYPE_WAVEOUT) を処理するオーディオ行に関する情報を取得するために使用されます。 アプリケーションは、mixerGetLineInfo を呼び出す前に、MIXERLINE 構造体の dwType、wMid、wPid、vDriverVersion、szPname メンバーを初期化する必要があります。 これらの値はすべて、すべてのメディア デバイスのデバイス機能構造から取得できます。 cbStruct を除く残りの構造体メンバーは、それ以上初期化する必要はありません。
メモこの関数の ANSI バージョン (mixerGetLineInfoA) では、MIXER_GETLINEINFOF_TARGETTYPE フラグを指定して mixerGetLineInfo を呼び出すときに、mixerGetLineInfo または waveOutGetDevCaps から返される ANSI 文字列を psPname 文字列の値に使用することはできません。 その理由は、Unicode との間の内部変換が実行され、データが失われる可能性があるためです。
 
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_INVALLINE
 オーディオ行参照が無効です。
MMSYSERR_BADDEVICEID
 hmxobj パラメーターは、無効なデバイス識別子を指定します。
MMSYSERR_INVALFLAG
 1 つ以上のフラグが無効です。
MMSYSERR_INVALHANDLE
 hmxobj パラメーターは無効なハンドルを指定します。
MMSYSERR_INVALPARAM
 1 つ以上のパラメーターが無効です。
MMSYSERR_NODRIVER
 hmxobj で指定されたオブジェクトに対してミキサー デバイスを使用できません。

解説

注意

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

要件

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

関連項目

オーディオ ミキサー関数

オーディオ ミキサー