joyGetDevCaps 関数 (ジョイスティックapi.h)

joyGetDevCaps 関数は、ジョイスティックに対してクエリを実行してその機能を判断します。

構文

MMRESULT joyGetDevCaps(
  UINT      uJoyID,
  LPJOYCAPS pjc,
  UINT      cbjc
);

uJoyID

照会するジョイスティックの識別子。 uJoyID の有効な値の範囲は-1 ~ 15 です。値 -1 を指定すると、デバイスが存在するかどうかに関係なく、JOYCAPS 構造体の szRegKey メンバーを取得できます。

pjc

ジョイスティックの機能を格納する JOYCAPS 構造体へのポインター。

cbjc

JOYCAPS 構造体のサイズ (バイト単位)。

成功した場合JOYERR_NOERROR、または次のいずれかのエラー値を返します。

リターンコード	説明
MMSYSERR_NODRIVER	ジョイスティックドライバーが存在しないか、指定されたジョイスティック識別子が無効です。指定されたジョイスティック識別子が無効です。
MMSYSERR_INVALPARAM	無効なパラメーターが渡されました。

joyGetNumDevs 関数を使用して、ドライバーでサポートされているジョイスティックデバイスの数を確認します。

cbjc パラメーターに無効な値が渡されると、このメソッドは失敗します。


サポートされている最小のクライアント	Windows 2000 Professional [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows 2000 Server [デスクトップアプリのみ]
対象プラットフォーム	Windows
ヘッダー	ジョイスティックapi.h (Windows.h を含む)
Library	Winmm.lib
[DLL]	Winmm.dll