共用方式為

mixerSetControlDetails 函式 (mmeapi.h)

  • 發行項

混音器SetControlDetails 函式會設定與音訊線相關聯的單一控件屬性。

語法

MMRESULT mixerSetControlDetails(
  HMIXEROBJ             hmxobj,
  LPMIXERCONTROLDETAILS pmxcd,
  DWORD                 fdwDetails
);

參數

hmxobj

處理要設定屬性的混音器裝置物件。

pmxcd

混合器CONTROLDETAILS結構的指標。 這個結構可用來參考包含控制項所需狀態的控制項詳細數據結構。

fdwDetails

設定控件屬性的旗標。 定義下列值。

值 意義
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 函式所傳回之裝置數目的電壓音訊輸出裝置標識碼。
MIXER_SETCONTROLDETAILSF_CUSTOM 會顯示指定之自定義混音器控件的自定義對話方塊。 混音器裝置會從使用者收集必要的資訊，並傳回指定緩衝區中的數據。 擁有視窗的句柄是在MIXERCONTROLDETAILS結構的 hwndOwner 成員中指定。 (此句柄可以設定為 NULL.) 應用程式接著可以從對話框儲存數據，並在稍後使用 MIXER_SETCONTROLDETAILSF_VALUE 旗標將控件重設為相同狀態。
MIXER_SETCONTROLDETAILSF_VALUE 設定控制件的目前值 () 。 MIXERCONTROLDETAILS 結構的paDetails成員指向控件適當類別的一或多個混合器控件詳細數據結構。

傳回值

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

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

備註

在呼叫mixerSetControlDetails之前，必須先初始化MIXERCONTROLDETAILS結構的所有成員。

如果應用程式只需要擷取自定義混音器控件的目前狀態，且未顯示對話框，則 mixerGetControlDetails 可以搭配 MIXER_GETCONTROLDETAILSF_VALUE旗標使用。

規格需求

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

另請參閱

音訊混音器函式

音訊混音器