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

joyGetPos 関数は、ジョイスティックの位置とボタンの状態を照会します。

構文

MMRESULT joyGetPos(
  UINT      uJoyID,
  LPJOYINFO pji
);

パラメーター

uJoyID

クエリを実行するジョイスティックの識別子。 uJoyID の有効な値の範囲は、0 (ジョイスティック ID1) から 15 です。

pji

ジョイスティックの位置とボタンの状態を含む JOYINFO 構造体へのポインター。

戻り値

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

リターン コード 説明
MMSYSERR_NODRIVER
ジョイスティック ドライバーが存在しません。
MMSYSERR_INVALPARAM
無効なパラメーターが渡されました。
JOYERR_UNPLUGGED
指定されたジョイスティックがシステムに接続されていません。

解説

4 ~ 6 軸の移動軸、視点コントロール、または 4 つ以上のボタンを持つデバイスの場合は、 joyGetPosEx 関数を使用します。

要件

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

関連項目

ジョイスティック

マルチメディアジョイスティック関数