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

  • [アーティクル]

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

構文

MMRESULT joyGetPosEx(
  UINT        uJoyID,
  LPJOYINFOEX pji
);

パラメーター

uJoyID

照会するジョイスティックの識別子。 uJoyID の有効な値の範囲は 0 (JOYSTICKID1) から 15 です。

pji

ジョイスティックの拡張位置情報とボタンの状態を含む JOYINFOEX 構造体へのポインター。 dwSize メンバーと dwFlags メンバーを設定する必要があります。または joyGetPosEx は失敗します。 joyGetPosEx から返される情報は、dwFlags で指定したフラグによって異なります。

戻り値

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

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

注釈

この機能は、ラダーペダル、視点の帽子、ボタンの数が多いデバイス、最大6軸を使用する座標系などの拡張デバイスへのアクセスを提供します。 3 つの軸以下を使用し、ボタンが 4 つ未満のジョイスティック デバイスの場合は、 joyGetPos 関数を使用します。

要件

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

こちらもご覧ください

ジョイスティック

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