共用方式為


auxGetDevCapsA 函式 (mmeapi.h)

auxGetDevCaps 函式會擷取指定輔助輸出裝置的功能。

語法

MMRESULT auxGetDevCapsA(
  UINT_PTR   uDeviceID,
  LPAUXCAPSA pac,
  UINT       cbac
);

參數

uDeviceID

要查詢之輔助輸出裝置的識別碼。 指定有效的裝置識別碼(請參閱下列批注區段),或使用下列常數:

價值 意義
AUX_MAPPER 輔助音訊對應程式。 如果未安裝任何輔助音訊對應程式,函式會傳回錯誤。

pac

要填入裝置功能相關信息的 AUXCAPS 結構的指標。

cbac

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

傳回值

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

傳回碼 描述
MMSYSERR_BADDEVICEID
指定的裝置識別碼超出範圍。

言論

uDeviceID 中的裝置標識碼會從零到一個小於現有裝置數目。 也可以使用AUX_MAPPER。 使用 auxGetNumDevs 函式來判斷系統中存在的輔助輸出裝置數目。

注意

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

要求

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

另請參閱

電壓音訊

波函式