mixerGetLineInfoA 函式 （mmeapi.h）
混音器GetLineInfo 函式會擷取混合器裝置特定線路的相關信息。
語法
MMRESULT mixerGetLineInfoA(
HMIXEROBJ hmxobj,
LPMIXERLINEA pmxl,
DWORD fdwInfo
);
參數
hmxobj
控制特定音訊線的混音器裝置物件句柄。
pmxl
MIXERLINE 結構的指標。 此結構會填入混音器裝置音訊線的相關信息。 cbStruct 成員必須一律初始化為 MIXERLINE 結構的大小，以位元組為單位。
fdwInfo
擷取音訊線相關信息的旗標。 定義下列值。
| 價值 | 意義 |
|---|---|
| MIXER_GETLINEINFOF_COMPONENTTYPE | pmxl 參數將接收 dwComponentType 中所指定類型之第一個音訊線的相關信息，MIXERLINE 結構的成員。 此旗標可用來擷取特定元件類型的音訊線相關信息。 除了 cbStruct 以外的其餘結構成員不需要進一步初始化。 |
| MIXER_GETLINEINFOF_DESTINATION | |
| MIXER_GETLINEINFOF_LINEID | pmxl 參數會收到 MIXERLINE 結構之 dwLine ID 所指定之音訊線的相關信息。 這通常用來擷取音訊線狀態的更新資訊。 除了 cbStruct 以外的所有其餘結構成員都不需要進一步初始化。 |
| MIXER_GETLINEINFOF_SOURCE | pmxl 參數會接收 dwDestination 所指定來源音訊線的相關信息，以及 dwSourceMIXERLINE 結構的成員。 dwDestination 所指定的索引 範圍從零到一個小於 cDestinationsMIXERCAPS 結構成員的值。 dwSource 所指定的索引 範圍從零到小於 cConnections cConnections 中 成員 MIXERLINE 結構中針對儲存在 dwDestination 成員中的音頻行所傳回的值。 除了 cbStruct 以外的所有其餘結構成員都不需要進一步初始化。 |
| MIXER_GETLINEINFOF_TARGETTYPE |
pmxl 參數會收到 dwType 成員 Target 結構之音訊線的相關信息，這是 MIXERLINE 結構的成員。 這個旗標可用來擷取處理目標類型的音訊線相關信息（例如，MIXERLINE_TARGETTYPE_WAVEOUT）。 應用程式必須先初始化 dwType、wMid、wPid、vDriverVersion，以及 szPname，再呼叫 mixerGetLineInfo。 所有這些值都可以從所有媒體裝置的裝置功能結構擷取。 除了 cbStruct 以外的其餘結構成員不需要進一步初始化。
|
| MIXER_OBJECTF_AUX | hmxobj 參數是零到一個小於 auxGetNumDevs 函式所傳回裝置數目的輔助裝置識別符。 |
| MIXER_OBJECTF_HMIDIIN |
hmxobj 參數是 MIDI 輸入設備的句柄。 此句柄必須由midiInOpen 函式 |
| MIXER_OBJECTF_HMIDIOUT |
hmxobj 參數是 MIDI 輸出裝置的句柄。 此句柄必須由midiOutOpen 函式 |
| MIXER_OBJECTF_HMIXER | hmxobj 參數是 混合器Open 函式所傳回的混音器裝置句柄。 這個旗標是選擇性的。 |
| MIXER_OBJECTF_HWAVEIN | hmxobj 參數是 waveInOpen 函式所傳回的波浪音訊輸入句柄。 |
| MIXER_OBJECTF_HWAVEOUT | hmxobj 參數是 waveOutOpen 函式所傳回的超聲波音頻輸出句柄。 |
| MIXER_OBJECTF_MIDIIN | hmxobj 參數是 MIDI 輸入裝置的識別碼。 此標識碼的範圍必須小於 midiInGetNumDevs 函式所傳回的裝置數目。 |
| MIXER_OBJECTF_MIDIOUT | hmxobj 參數是 MIDI 輸出裝置的識別碼。 此標識碼的範圍必須小於 midiOutGetNumDevs 函式所傳回的裝置數目。 |
| MIXER_OBJECTF_MIXER | hmxobj 參數是混音器裝置標識符，範圍在零到一個小於 mixerGetNumDevs 函式所傳回的裝置數目。 這個旗標是選擇性的。 |
| MIXER_OBJECTF_WAVEIN | hmxobj 參數是介於零到一個小於 waveInGetNumDevs 函式所傳回裝置數目的電壓音訊輸入裝置標識符。 |
| MIXER_OBJECTF_WAVEOUT | hmxobj 參數是介於零到一個小於 waveOutGetNumDevs 函式所傳回裝置數目的電壓音訊輸出裝置標識符。 |
傳回值
如果成功或發生錯誤，則傳回MMSYSERR_NOERROR。 可能的錯誤值包括下列專案。
| 傳回碼 | 描述 |
|---|---|
|
音訊線路參考無效。 |
|
hmxobj 參數會指定無效的裝置識別碼。 |
|
一或多個旗標無效。 |
|
hmxobj 參數會指定無效的句柄。 |
|
一或多個參數無效。 |
|
hmxobj所指定的對象沒有混音器裝置。 |
言論
注意
mmeapi.h 標頭會將mixerGetLineInfo定義為別名，根據UNICODE預處理器常數的定義，自動選取此函式的ANSI或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | mmeapi.h （包括 Windows.h） |
| 連結庫 | Winmm.lib |
| DLL | Winmm.dll |