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

関連項目

ジョイスティック

マルチメディアジョイスティック機能