共用方式為

mixerGetControlDetailsW 函式 (mmeapi.h)

  • 發行項

混音器GetControlDetails 函式會擷取與音訊線相關聯之單一控制項的詳細資料。

語法

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

參數

hmxobj

正在查詢混音器裝置物件的控制碼。

pmxcd

將指標指標填入控制項的狀態資訊中，指向 MIXERCONTROLDETAILS 結構。

fdwDetails

用於擷取控制項詳細資料的旗標。 定義下列值。

值 意義
MIXER_GETCONTROLDETAILSF_LISTTEXT MIXERCONTROLDETAILS結構的paDetails成員指向一或多個MIXERCONTROLDETAILS_LISTTEXT結構，以接收多專案控制項的文字標籤。 應用程式必須一次取得多個專案控制項的所有清單文字專案。 此旗標無法與MIXERCONTROL_CONTROLTYPE_CUSTOM控制項搭配使用。
MIXER_GETCONTROLDETAILSF_VALUE 擷取控制項的目前值。 MIXERCONTROLDETAILS結構的paDetails成員會指向一或多個適用于控制項類別的詳細資料結構。
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。 可能的錯誤值包括下列專案。

傳回碼 描述
MIXERR_INVALCONTROL
 控制項參考無效。
MMSYSERR_BADDEVICEID
 hmxobj參數會指定不正確裝置識別碼。
MMSYSERR_INVALFLAG
 一或多個旗標無效。
MMSYSERR_INVALHANDLE
 hmxobj參數會指定不正確控制碼。
MMSYSERR_INVALPARAM
 一或多個參數無效。
MMSYSERR_NODRIVER
 hmxobj所指定的物件沒有可用的混音器裝置。

備註

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

注意

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

需求

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

另請參閱

音訊混音器函式

音訊混音器