mixerGetDevCaps 函式 (mmeapi.h)
混合器GetDevCaps 函式會查詢指定的混音器裝置來判斷其功能。
語法
MMRESULT mixerGetDevCaps(
UINT uMxId,
LPMIXERCAPS pmxcaps,
UINT cbmxcaps
);
參數
uMxId
開啟混音器裝置的標識碼或句柄。
pmxcaps
可接收裝置功能相關信息的 MIXERCAPS 結構的指標。
cbmxcaps
混合器CAPS 結構的大小,以位元組為單位。
傳回值
如果成功或發生錯誤,則傳回MMSYSERR_NOERROR。 可能的錯誤值包括下列專案。
傳回碼 | Description |
---|---|
|
指定的裝置識別碼超出範圍。 |
|
混音器裝置控點無效。 |
|
一或多個參數無效。 |
備註
使用 混合器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 |