joyGetDevCapsA 函式 (遊戲桿api.h)

joyGetDevCaps 函式會查詢遊戲桿來判斷其功能。

語法

MMRESULT joyGetDevCapsA(
  UINT_PTR   uJoyID,
  LPJOYCAPSA pjc,
  UINT       cbjc
);

uJoyID

要查詢之遊戲桿的識別碼。 uJoyID 的有效值範圍從 -1 到 15。值 -1 可擷取無論裝置是否存在的 SzRegKey 結構 SzRegKey 成員。

pjc

要包含遊戲桿功能的 JOYCAPS 結構的指標。

cbjc

為 JOYCAPS 結構的大小，以位元組為單位。

如果成功或下列其中一個錯誤值，則傳回JOYERR_NOERROR：

傳回碼	Description
MMSYSERR_NODRIVER	遊戲桿驅動程式不存在，或指定的遊戲桿標識碼無效。指定的遊戲桿識別碼無效。
MMSYSERR_INVALPARAM	傳遞了一個無效的參數。

使用 joyGetNumDevs 函式來判斷驅動程式支援的遊戲桿裝置數目。

當傳遞 cbjc 參數的無效值時，這個方法會失敗。

注意

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

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