joyGetPosEx 関数 (ジョイスティックapi.h)
joyGetPosEx 関数は、ジョイスティックの位置とボタンの状態を照会します。
構文
MMRESULT joyGetPosEx(
UINT uJoyID,
LPJOYINFOEX pji
);
パラメーター
uJoyID
照会するジョイスティックの識別子。 uJoyID の有効な値の範囲は 0 (JOYSTICKID1) から 15 です。
pji
ジョイスティックの拡張位置情報とボタンの状態を含む JOYINFOEX 構造体へのポインター。 dwSize メンバーと dwFlags メンバーを設定する必要があります。または joyGetPosEx は失敗します。 joyGetPosEx から返される情報は、dwFlags で指定したフラグによって異なります。
戻り値
成功した場合JOYERR_NOERROR、または次のいずれかのエラー値を返します。
リターン コード | 説明 |
---|---|
|
ジョイスティック ドライバーが存在しません。 |
|
無効なパラメーターが渡されました。 |
|
指定されたジョイスティック識別子が無効です。 |
|
指定されたジョイスティックがシステムに接続されていません。 |
|
指定されたジョイスティック識別子が無効です。 |
注釈
この機能は、ラダーペダル、視点の帽子、ボタンの数が多いデバイス、最大6軸を使用する座標系などの拡張デバイスへのアクセスを提供します。 3 つの軸以下を使用し、ボタンが 4 つ未満のジョイスティック デバイスの場合は、 joyGetPos 関数を使用します。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 2000 Professional [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows 2000 Server [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | ジョイスティックapi.h (Windows.h を含む) |
Library | Winmm.lib |
[DLL] | Winmm.dll |