共用方式為

mixerGetControlDetailsA 函式 （mmeapi.h）

  • 發行項

混音器GetControlDetails 函式會擷取與音訊線相關聯之單一控件的詳細數據。

語法

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

參數

hmxobj

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

pmxcd

MIXERCONTROLDETAILS 結構的指標，其中包含控件的狀態資訊。

fdwDetails

擷取控件詳細數據的旗標。 定義下列值。

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

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

言論

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

注意

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

要求

要求 價值
最低支援的用戶端 Windows 2000 Professional [僅限傳統型應用程式]
支援的最低伺服器 Windows 2000 Server [僅限傳統型應用程式]
目標平臺 窗戶
標頭 mmeapi.h （包括 Mmeapi.h、Windows.h）
連結庫 Winmm.lib
DLL Winmm.dll

另請參閱

音訊混音器函式

音訊混音器