mixerGetLineControls 函式 (mmeapi.h)
混音器GetLineControls函式會擷取與音訊線相關聯的一或多個控制項。
語法
MMRESULT mixerGetLineControls(
HMIXEROBJ hmxobj,
LPMIXERLINECONTROLS pmxlc,
DWORD fdwControls
);
參數
hmxobj
正在查詢的混合器裝置物件的控制碼。
pmxlc
混合器LINECONTROLS結構的指標。 這個結構可用來參考一或多個 MIXERCONTROL 結構，以填入與音訊線相關聯之控制項的相關資訊。 MIXERLINECONTROLS結構的cbStruct成員必須一律初始化為MIXERLINECONTROLS結構的大小，以位元組為單位。
fdwControls
用來擷取與音訊線相關聯之一或多個控制項相關資訊的旗標。 定義下列值。
| 值 | 意義 |
|---|---|
| MIXER_GETLINECONTROLSF_ALL | pmxlc參數會參考一份 MIXERCONTROL結構清單，該結構會接收與 MIXERLINECONTROLS結構之 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控制項變更通知訊息之後重新整理控制項 ， (請參閱 mixerOpen) 。 |
| MIXER_GETLINECONTROLSF_ONEBYTYPE | 混音器GetLineControls函式會擷取所查詢之音訊線之特定類別之第一個控制項的相關資訊。 pmxlc參數會參考將接收特定控制項相關資訊的單一MIXERCONTROL結構。 音訊線是由 dwLineID 成員識別。 控制項類別是在MIXERLINECONTROLS結構的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。 可能的錯誤值包括下列專案。
| 傳回碼 | 描述 |
|---|---|
|
控制項參考無效。 |
|
音訊線參考無效。 |
|
hmxobj參數會指定不正確裝置識別碼。 |
|
一或多個旗標無效。 |
|
hmxobj參數會指定不正確控制碼。 |
|
一或多個參數無效。 |
|
hmxobj所指定的物件沒有混合器裝置可用。 |
需求
| 最低支援的用戶端 | Windows 2000 專業版 [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows 2000 Server [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | mmeapi.h (包含 Windows.h) |
| 程式庫 | Winmm.lib |
| Dll | Winmm.dll |