mixerGetLineControlsA 函式 （mmeapi.h）
混音器GetLineControls 函式會擷取與音訊線相關聯的一或多個控件。
語法
MMRESULT mixerGetLineControlsA(
HMIXEROBJ hmxobj,
LPMIXERLINECONTROLSA pmxlc,
DWORD fdwControls
);
參數
hmxobj
正在查詢的混音器裝置物件的句柄。
pmxlc
MIXERLINECONTROLS 結構的指標。 這個結構可用來參考一或多個 MIXERCONTROL 結構，以填入與音訊線相關聯之控件的相關信息。 cbStruct member of the MIXERLINECONTROLS structure must be initialized to the size， in bytes， of the MIXERLINECONTROLS structure.
fdwControls
用來擷取與音訊線相關聯之一或多個控件相關信息的旗標。 定義下列值。
| 價值 | 意義 |
|---|---|
| MIXER_GETLINECONTROLSF_ALL |
pmxlc 參數會參考一份 MIXERCONTROL 結構清單，該結構會接收與 DWLine ID 所識別之音訊線相關聯之所有控件的相關信息，MIXERLINECONTROLS 結構的成員。
cControls 成員必須初始化為與行相關聯的控件數目。 這個數位是從 |
| MIXER_GETLINECONTROLSF_ONEBYID | pmxlc 參數會參考單一 MIXERCONTROL 結構，該結構會接收 dwControlID 成員 MIXERLINECONTROLS 結構所識別之控件的相關信息。 cControls 成員必須初始化為 1。 cbmxctrl 成員必須初始化為單一 MIXERCONTROL 結構的大小，以位元組為單位。 pamxctrl 成員必須指向要填滿的 MIXERCONTROL 結構。 此查詢會忽略 dwLineID 和 dwControlType 成員。 此查詢通常用來在使用者定義回呼收到 MM_MIXM_CONTROL_CHANGE 控件變更通知訊息之後重新整理控件（請參閱 mixerOpen）。 |
| MIXER_GETLINECONTROLSF_ONEBYTYPE | 混音器GetLineControls 函式會擷取所查詢音訊線之特定類別之第一個控件的相關信息。 pmxlc 參數會參考將接收特定控件相關信息的單一 MIXERCONTROL 結構。 音訊行是由 dwLineID 成員所識別。 控件類別是在 dwControlType 中指定，MIXERLINECONTROLS 結構的成員。此查詢會忽略 dwControlID 成員。 應用程式可以使用此查詢來取得與這一行相關聯的單一控件資訊。 例如，您可能希望應用程式只使用來自超聲波音頻輸出線的尖峰計量。 |
| 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 標頭會根據 UNICODE 預處理器常數的定義，將混合器GetLineControls 定義為自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱函式原型的
要求
| 要求 | 價值 |
|---|---|
| 最低支援的用戶端 | Windows 2000 Professional [僅限傳統型應用程式] |
| 支援的最低伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平臺 | 窗戶 |
| 標頭 | mmeapi.h （包括 Windows.h） |
| 連結庫 | Winmm.lib |
| DLL | Winmm.dll |