次の方法で共有

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

  • [アーティクル]

joyGetDevCaps 関数は、ジョイスティックを照会してその機能を判断します。

構文

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

パラメーター

uJoyID

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

pjc

ジョイスティックの機能を含む JOYCAPS 構造体へのポインター。

cbjc

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

戻り値

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

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

備考

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

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

手記

ジョイスティックapi.h ヘッダーは、UNICODE プリプロセッサ定数の定義に基づいて、この関数の ANSI または Unicode バージョンを自動的に選択するエイリアスとして joyGetDevCaps を定義します。 エンコードに依存しないエイリアスをエンコードに依存しないコードと組み合わせて使用すると、コンパイルエラーやランタイム エラーが発生する不一致が発生する可能性があります。 詳細については、「関数プロトタイプの 規則」を参照してください。

必要条件

要件 価値
サポートされる最小クライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされる最小サーバー Windows 2000 Server [デスクトップ アプリのみ]
ターゲット プラットフォーム の ウィンドウズ
ヘッダー joystickapi.h (Windows.h を含む)
ライブラリ Winmm.lib
DLL Winmm.dll

関連項目

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