如何通过WIN32原始输入区分Xbox手柄的左右扳机键？

问题根源 #

Xbox手柄的左右扳机在HID协议中是两个独立的Usage项：左扳机对应Usage 0x30，右扳机对应Usage 0x31，二者同属Generic Desktop Usage Page（0x01）。你当前的代码通过遍历pValueCaps并使用Range.UsageMin获取值，会导致两者同时按压时状态重叠覆盖——因为该逻辑没有针对两个独立的Usage分别取值，无法分离各自的原始数据。

你观察到的异常数值，本质是Xbox手柄原始HID数据中左右扳机的位域被打包存储，直接通过单个ValueCap解析会出现数据混淆。

修正方案 #

不要依赖遍历pValueCaps的通用逻辑，直接针对左右扳机的具体Usage单独调用HidP_GetUsageValue，确保分别获取两者的独立状态：

修改后的代码 #

// 定义左右扳机的固定Usage与Usage Page
#define TRIGGER_USAGE_PAGE 0x01    // Generic Desktop页
#define LEFT_TRIGGER_USAGE 0x30    // 左扳机Usage值
#define RIGHT_TRIGGER_USAGE 0x31   // 右扳机Usage值

ULONG leftTrigger = 0;
ULONG rightTrigger = 0;

// 单独获取左扳机状态
NTSTATUS statusLeft = HidP_GetUsageValue(
    HidP_Input,
    TRIGGER_USAGE_PAGE,
    0,
    LEFT_TRIGGER_USAGE,
    &leftTrigger,
    device->pPreParsedData,
    (PCHAR)raw->data.hid.bRawData,
    raw->data.hid.dwSizeHid
);

// 单独获取右扳机状态
NTSTATUS statusRight = HidP_GetUsageValue(
    HidP_Input,
    TRIGGER_USAGE_PAGE,
    0,
    RIGHT_TRIGGER_USAGE,
    &rightTrigger,
    device->pPreParsedData,
    (PCHAR)raw->data.hid.bRawData,
    raw->data.hid.dwSizeHid
);

if (statusLeft == HIDP_STATUS_SUCCESS && statusRight == HIDP_STATUS_SUCCESS)
{
    // 存储独立的扳机状态（实际有效范围为0~0xFF，可按需取低8位）
    gControllerState.leftTrigger = leftTrigger & 0xFF;
    gControllerState.rightTrigger = rightTrigger & 0xFF;
}
else
{
    printf("Error getting trigger values\n");
    return;
}

// 保留原有其他按键/轴的遍历逻辑（跳过扳机相关项避免重复处理）
for (UINT i = 0; i < device->numValueCaps; i++)
{
    HIDP_VALUE_CAP* cap = &device->pValueCaps[i];
    if (cap->UsagePage == TRIGGER_USAGE_PAGE && 
        (cap->Range.UsageMin == LEFT_TRIGGER_USAGE || cap->Range.UsageMin == RIGHT_TRIGGER_USAGE))
    {
        continue;
    }

    ULONG value;
    if (HidP_GetUsageValue(HidP_Input, 
                           cap->UsagePage, 
                           0, 
                           cap->Range.UsageMin, 
                           &value, 
                           device->pPreParsedData, 
                           (PCHAR)raw->data.hid.bRawData, 
                           raw->data.hid.dwSizeHid) != HIDP_STATUS_SUCCESS)
    {
        printf("Error getting usage value\n");
        return;
    }

    gControllerState.wValues[i] = value;
}

补充说明 #

1. Xbox手柄的扳机有效取值范围为0（完全释放）到0xFF（完全按下），你之前看到的长ULONG值是原始位域被直接解析为32位整数的结果，取低8位即可得到真实压力值。
2. 硬编码左右扳机的Usage是最可靠的方式，因为Xbox手柄的HID报告格式是固定的；若需更通用的适配，可遍历pValueCaps时通过UsagePage和Usage匹配扳机项，但流程会更复杂。

内容的提问来源于stack exchange，提问作者Jaysmito Mukherjee