joyGetDevCapsW 函式 (joystickapi.h)

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

語法

MMRESULT joyGetDevCapsW(
  UINT_PTR   uJoyID,
  LPJOYCAPSW pjc,
  UINT       cbjc
);

uJoyID

要查詢之搖桿的識別碼。 uJoyID的有效值範圍從 -1 到 15。值 -1 可擷取不論裝置是否存在，都能夠擷取JOYCAPS結構的szRegKey成員。

pjc

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

cbjc

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

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

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

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

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

注意

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