XINPUT_GAMEPAD 結構 ()

  • 發行項

描述控制器的目前狀態。

語法

typedef struct _XINPUT_GAMEPAD {
  WORD  wButtons;
  BYTE  bLeftTrigger;
  BYTE  bRightTrigger;
  SHORT sThumbLX;
  SHORT sThumbLY;
  SHORT sThumbRX;
  SHORT sThumbRY;
} XINPUT_GAMEPAD, *PXINPUT_GAMEPAD;

成員

wButtons

裝置數位按鈕的位掩碼，如下所示。 設定位表示已按下對應的按鈕。

裝置按鈕 位掩碼
XINPUT_GAMEPAD_DPAD_UP 0x0001
XINPUT_GAMEPAD_DPAD_DOWN 0x0002
XINPUT_GAMEPAD_DPAD_LEFT 0x0004
XINPUT_GAMEPAD_DPAD_RIGHT 0x0008
XINPUT_GAMEPAD_START 0x0010
XINPUT_GAMEPAD_BACK 0x0020
XINPUT_GAMEPAD_LEFT_THUMB 0x0040
XINPUT_GAMEPAD_RIGHT_THUMB 0x0080
XINPUT_GAMEPAD_LEFT_SHOULDER 0x0100
XINPUT_GAMEPAD_RIGHT_SHOULDER 0x0200
XINPUT_GAMEPAD_A 0x1000
XINPUT_GAMEPAD_B 0x2000
XINPUT_GAMEPAD_X 0x4000
XINPUT_GAMEPAD_Y 0x8000
 

已設定但未定義上述的位會保留，且其狀態為未定義。

bLeftTrigger

左觸發程式類比控制項的目前值。 此值介於 0 到 255 之間。

bRightTrigger

右觸發程式類比控制元件的目前值。 此值介於 0 到 255 之間。

sThumbLX

左遊戲桿 x 軸值。 每個遊戲桿軸成員都是 -32768 與 32767 之間的帶正負號值，描述遊戲桿的位置。 值為 0 的置中。 負值表示向下或向左表示。 正值表示或向右表示。 常數XINPUT_GAMEPAD_LEFT_THUMB_DEADZONE或XINPUT_GAMEPAD_RIGHT_THUMB_DEADZONE可用來做為正值和負值，以篩選遊戲桿輸入。

sThumbLY

左遊戲桿 Y 軸值。 此值介於 -32768 和 32767 之間。

sThumbRX

右遊戲桿 x 軸值。 此值介於 -32768 和 32767 之間。

sThumbRY

右遊戲桿 Y 軸值。 此值介於 -32768 和 32767 之間。

備註

輪詢控制器狀態變更時， XINPUT_STATE 結構會使用此結構。

按鈕與遊戲函式的特定對應會根據遊戲類型而有所不同。

常數XINPUT_GAMEPAD_TRIGGER_THRESHOLD可用來做為 bLeftTrigger 和 bRightTrigger 必須大於才能登錄為按下的值。 這是選擇性的，但通常是想要的。 控制器按鈕不會指令清單交叉追蹤。

規格需求

需求 值
標頭 xinput.h

另請參閱

XINPUT_STATE

XInput 結構

XInputGetState