mixerGetDevCaps 函式 (mmeapi.h)

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

語法

MMRESULT mixerGetDevCaps(
  UINT        uMxId,
  LPMIXERCAPS pmxcaps,
  UINT        cbmxcaps
);

參數

uMxId

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

pmxcaps

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

cbmxcaps

混合器CAPS 結構的大小,以位元組為單位。

傳回值

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

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

備註

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

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

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

規格需求

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

另請參閱

音訊混音器函式

音訊混音器