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