mixerGetLineInfoW 関数 (mmeapi.h)
mixerGetLineInfo 関数は、ミキサー デバイスの特定の行に関する情報を取得します。
構文
MMRESULT mixerGetLineInfoW(
HMIXEROBJ hmxobj,
LPMIXERLINEW pmxl,
DWORD fdwInfo
);
パラメーター
hmxobj
特定のオーディオ行を制御するミキサー デバイス オブジェクトを処理します。
pmxl
MIXERLINE 構造体へのポインター。 この構造体には、ミキサー デバイスのオーディオラインに関する情報が格納されます。 cbStruct メンバーは、MIXERLINE 構造体のサイズ (バイト単位) に常に初期化する必要があります。
fdwInfo
オーディオ行に関する情報を取得するためのフラグ。 次の値が定義されています。
| 価値 | 意味 |
|---|---|
| MIXER_GETLINEINFOF_COMPONENTTYPE |
pmxl パラメーターは、MIXERLINE 構造体の dwComponentType メンバーで指定された型の最初のオーディオ行に関する情報を受け取ります。 このフラグは、特定のコンポーネントの種類のオーディオ行に関する情報を取得するために使用されます。 cbStruct を除く残りの構造体メンバー |
| MIXER_GETLINEINFOF_DESTINATION |
pmxl パラメーターは、MIXERLINE 構造体の dwDestination メンバーによって指定された宛先オーディオ行に関する情報を受け取ります。 このインデックスの範囲は、 |
| MIXER_GETLINEINFOF_LINEID |
pmxl パラメーターは、MIXERLINE 構造体の dwLineID メンバーによって指定されたオーディオ行に関する情報を受け取ります。 これは通常、オーディオラインの状態に関する更新された情報を取得するために使用されます。 cbStruct |
| MIXER_GETLINEINFOF_SOURCE | |
| MIXER_GETLINEINFOF_TARGETTYPE |
pmxl パラメーターは、MIXERLINE 構造体のメンバーである Target 構造体の dwType メンバーに関するオーディオ行に関する情報を受け取ります。 このフラグは、ターゲットの種類 (たとえば、MIXERLINE_TARGETTYPE_WAVEOUT) を処理するオーディオ行に関する情報を取得するために使用されます。 アプリケーションは、mixerGetLineInfoを呼び出す前に、 |
| 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 関数によって返されるデバイスの数より 1 未満の 0 の範囲のミキサー デバイス識別子です。 このフラグは省略可能です。 |
| MIXER_OBJECTF_WAVEIN | hmxobj パラメーターは、waveInGetNumDevs 関数によって返されるデバイスの数より 1 未満の 0 の範囲の波形オーディオ入力デバイスの識別子です。 |
| MIXER_OBJECTF_WAVEOUT | hmxobj パラメーターは、waveOutGetNumDevs 関数によって返されるデバイスの数より 1 未満の 0 の範囲の波形オーディオ出力デバイスの識別子です。 |
戻り値
成功した場合はMMSYSERR_NOERRORを返し、それ以外の場合はエラーを返します。 考えられるエラー値は次のとおりです。
| リターン コード | 形容 |
|---|---|
|
オーディオ行参照が無効です。 |
|
hmxobj パラメーターは、無効なデバイス識別子を指定します。 |
|
1 つ以上のフラグが無効です。 |
|
hmxobj パラメーターは無効なハンドルを指定します。 |
|
1 つ以上のパラメーターが無効です。 |
|
hmxobjで指定されたオブジェクトに対してミキサー デバイス |
備考
手記
mmeapi.h ヘッダーは、unicode プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして mixerGetLineInfo を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
| サポートされる最小サーバー | Windows 2000 Server [デスクトップ アプリのみ] |
| ターゲット プラットフォーム の |
ウィンドウズ |
| ヘッダー | mmeapi.h (Windows.h を含む) |
| ライブラリ | Winmm.lib |
| DLL | Winmm.dll |