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


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