共用方式為


mixerGetDevCapsA 函式 (mmeapi.h)

混音器GetDevCaps 函式會查詢指定的混音器裝置,以判斷其功能。

語法

MMRESULT mixerGetDevCapsA(
  UINT_PTR     uMxId,
  LPMIXERCAPSA pmxcaps,
  UINT         cbmxcaps
);

參數

uMxId

開啟混音器裝置的標識碼或句柄。

pmxcaps

MIXERCAPS 結構的指標,該結構會接收裝置功能的相關信息。

cbmxcaps

大小,以位元組為單位,MIXERCAPS 結構。

傳回值

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

傳回碼 描述
MMSYSERR_BADDEVICEID
指定的裝置識別碼超出範圍。
MMSYSERR_INVALHANDLE
混音器裝置句柄無效。
MMSYSERR_INVALPARAM
一或多個參數無效。

言論

使用 mixerGetNumDevs 函式來判斷系統中存在的混音器裝置數目。 uMxId 所指定的裝置識別碼 會從零到一個小於現有混音器裝置數目。

只有 cbmxcaps 中所指定資訊的位元元組數(或更少)數目, 會複製到 pmxcaps 所指向的位置。 如果 cbmxcaps 為零,則不會複製任何專案,且函式會成功傳回。

此函式也會接受 mixerOpen 函式所傳回的混音器裝置句柄,做為 uMxId 參數。 應用程式應該將 HMIXER 句柄轉換成 UINT

注意

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

要求

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

另請參閱

音訊混音器函式

音訊混音器