共用方式為

mixerGetLineControlsA 函式 (mmeapi.h)

  • 發行項

混音器GetLineControls 函式會擷取與音訊線相關聯的一或多個控件。

語法

MMRESULT mixerGetLineControlsA(
  HMIXEROBJ            hmxobj,
  LPMIXERLINECONTROLSA pmxlc,
  DWORD                fdwControls
);

參數

hmxobj

正在查詢的混音器裝置物件的句柄。

pmxlc

混合器LINECONTROLS結構的指標。 這個結構是用來參考一或多個以音訊線相關聯之控件的相關信息填滿 的一或多個 MIXERCONTROL 結構。 MIXERLINECONTROLS 結構的 cbStruct 成員必須一律初始化為混合器LINECONTROLS 結構的大小，以位元組為單位。

fdwControls

用來擷取與音訊線相關聯之一或多個控件相關信息的旗標。 定義下列值。

值 意義
MIXER_GETLINECONTROLSF_ALL pmxlc 參數會參考一份混合器CONTROL 結構清單，這些結構會接收與一個混合器LINECONTROLS 結構之 dwLineID 成員所識別之音訊線相關聯之所有控件的相關信息。 cControls 成員必須初始化為與行相關聯的控件數目。 這個數位是從混合器GetLineInfo 函式所傳回之MIXERLINE結構的 cControls 成員擷取。 cbmxctrl 成員必須初始化為單一 MIXERCONTROL 結構的大小，以位元組為單位。 pamxctrl 成員必須指向要填滿的第一個MIXERCONTROL結構。 此查詢會忽略 dwControlID 和 dwControlType 成員。
MIXER_GETLINECONTROLSF_ONEBYID pmxlc 參數會參考單一的MIXERCONTROL結構，該結構會接收一個由MIXERLINECONTROLS結構之 dwControlID成員所識別之控件的資訊。 cControls 成員必須初始化為 1。 cbmxctrl 成員必須初始化為單一 MIXERCONTROL 結構的大小，以位元組為單位。 pamxctrl 成員必須指向要填滿的MIXERCONTROL結構。 此查詢會忽略 dwLineID 和 dwControlType 成員。 此查詢通常用來在使用者定義回呼收到 MM_MIXM_CONTROL_CHANGE 控件變更通知訊息之後重新整理控件， (請參閱 混合器開啟) 。
MIXER_GETLINECONTROLSF_ONEBYTYPE 混音器GetLineControls 函式會擷取所查詢音訊線之特定類別之第一個控件的相關信息。 pmxlc 參數會參考將接收特定控件相關信息的單一 MIXERCONTROL 結構。 音訊線是由 dwLineID 成員所識別。 控件類別是在混合器LINECONTROLS 結構的 dwControlType 成員中指定。此查詢會忽略 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 參數是混合器裝置的標識符，範圍介於零到一個小於混合器GetNumDevs 函式傳回的裝置數目。 此旗標是選擇性的。
MIXER_OBJECTF_WAVEIN hmxobj 參數是介於零到一個小於 waveInGetNumDevs 函式所傳回裝置數目的電壓音訊輸入設備標識碼。
MIXER_OBJECTF_WAVEOUT hmxobj 參數是介於零到一個小於 waveOutGetNumDevs 函式所傳回裝置數目的電壓音訊輸出裝置標識碼。

傳回值

如果成功或發生錯誤，則傳回MMSYSERR_NOERROR。 可能的錯誤值包括下列專案。

傳回碼 Description
MIXERR_INVALCONTROL
 控件參考無效。
MIXERR_INVALLINE
 音訊行參考無效。
MMSYSERR_BADDEVICEID
 hmxobj 參數會指定無效的裝置標識碼。
MMSYSERR_INVALFLAG
 一或多個旗標無效。
MMSYSERR_INVALHANDLE
 hmxobj 參數會指定無效的句柄。
MMSYSERR_INVALPARAM
 一或多個參數無效。
MMSYSERR_NODRIVER
 hmxobj 所指定的對象沒有可用的混音器裝置。

備註

注意

mmeapi.h 標頭會將混合器GetLineControls 定義為別名，根據 UNICODE 預處理器常數的定義，自動選取此函式的 ANSI 或 Unicode 版本。 混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。 如需詳細資訊，請參閱 函式原型的慣例。

規格需求

需求 值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
最低支援的伺服器 Windows 2000 Server [僅限桌面應用程式]
目標平台 Windows
標頭 mmeapi.h (包含 Windows.h)
程式庫 Winmm.lib
Dll Winmm.dll

另請參閱

音訊混音器函式

音訊混音器