游戏手柄子系统（CategoryGamepad）

SDL 提供了底层的摇杆 API，该 API 仅将摇杆视为一堆无规则的按键、轴和方向键。如果你计划自行开发控制配置界面，这个底层 API 能提供极高的灵活性，但开发成本也很高——而如今我们所说的「摇杆」大多是主机风格的标准化游戏手柄。因此 SDL 在底层摇杆功能之上，封装了更易用的游戏手柄（Gamepad）API。

摇杆 vs 游戏手柄核心区别

摇杆（Joystick）：用「按键 3」「轴 2」这类无意义的数字标识输入；
游戏手柄（Gamepad）：用标准化的位置标识输入（如方向键、肩键、扳机键、A/B/X/Y 键，或 PS 手柄的 X/O/方块/三角键）。

标准化实现原理

SDL 通过「魔术配置字符串」将摇杆转换为标准化游戏手柄——该字符串定义了特定硬件的映射规则（如「检测到该硬件时，按键 2 按下等价于方向键上」）。

SDL 内置了主流控制器的配置，开箱即用；
若设备未被 SDL 识别，用户可通过环境变量添加自定义控制器配置。

基础使用前提

调用 SDL_Init() 时必须传入 SDL_INIT_GAMEPAD 标志（SDL 会扫描系统游戏手柄并加载对应驱动）；
若在 Steam 游戏中使用 SDL 游戏手柄功能，需先调用 SteamAPI_InitEx()，再初始化 SDL；
若需应用在后台时接收手柄事件，需在 SDL_Init() 前设置 SDL_HINT_JOYSTICK_ALLOW_BACKGROUND_EVENTS 提示；
应用必须支持手柄热插拔（Xbox、Steam Deck 等平台认证强制要求；macOS/Windows 使用 Windows.Gaming.Input 时，手柄可能在应用启动后才被识别）。

可选功能支持

游戏手柄支持震动、彩色 LED、触摸板、陀螺仪等可选功能（支持程度取决于手柄硬件和系统驱动）：

运行时通过 SDL_GetGamepadProperties() 检查 LED/震动能力；
通过 SDL_GetNumGamepadTouchpads() 检查触摸板数量；
通过 SDL_GamepadHasSensor() 检查陀螺仪/加速度计是否可用；
SDL 默认使用能力最强的驱动，也可通过 SDL_hints.h 中的摇杆相关提示调整系统驱动优先级。

函数

SDL_AddGamepadMapping：添加单个游戏手柄映射配置（传入魔术配置字符串）
SDL_AddGamepadMappingsFromFile：从文件加载游戏手柄映射配置（批量导入）
SDL_AddGamepadMappingsFromIO：从 IO 流加载游戏手柄映射配置（自定义数据源）
SDL_CloseGamepad：关闭已打开的游戏手柄（释放手柄资源）
SDL_GamepadConnected：检查指定游戏手柄是否处于已连接状态
SDL_GamepadEventsEnabled：检查游戏手柄事件是否启用（返回布尔值）
SDL_GamepadHasAxis：检查游戏手柄是否支持指定的标准化轴（如左摇杆X轴）
SDL_GamepadHasButton：检查游戏手柄是否支持指定的标准化按键（如 A 键）
SDL_GamepadHasSensor：检查游戏手柄是否配备指定传感器（如陀螺仪、加速度计）
SDL_GamepadSensorEnabled：检查游戏手柄指定传感器是否已启用
SDL_GetGamepadAppleSFSymbolsNameForAxis：获取苹果平台下游戏手柄轴对应的 SFSymbols 图标名称
SDL_GetGamepadAppleSFSymbolsNameForButton：获取苹果平台下游戏手柄按键对应的 SFSymbols 图标名称
SDL_GetGamepadAxis：获取游戏手柄指定标准化轴的当前值（范围：-32768 ~ 32767）
SDL_GetGamepadAxisFromString：将字符串（如 "leftx"）转换为 SDL_GamepadAxis 枚举值
SDL_GetGamepadBindings：获取游戏手柄的所有按键/轴绑定关系（标准化标识与硬件标识的映射）
SDL_GetGamepadButton：获取游戏手柄指定标准化按键的当前状态（1=按下，0=释放）
SDL_GetGamepadButtonFromString：将字符串（如 "a"）转换为 SDL_GamepadButton 枚举值
SDL_GetGamepadButtonLabel：获取游戏手柄按键的标准化标签（如 A/B/X/Y 或 X/O/方块/三角）
SDL_GetGamepadButtonLabelForType：根据手柄类型获取按键标签（适配 Xbox/PS 手柄差异）
SDL_GetGamepadConnectionState：获取游戏手柄的连接状态（已连接/断开/正在连接）
SDL_GetGamepadFirmwareVersion：获取游戏手柄的固件版本号
SDL_GetGamepadFromID：通过游戏手柄ID获取对应的 SDL_Gamepad 指针
SDL_GetGamepadFromPlayerIndex：通过玩家索引获取对应的 SDL_Gamepad 指针
SDL_GetGamepadGUIDForID：通过游戏手柄ID获取设备的 GUID 标识
SDL_GetGamepadID：获取已打开游戏手柄的实例ID
SDL_GetGamepadJoystick：获取游戏手柄对应的底层摇杆设备指针
SDL_GetGamepadMapping：获取已打开游戏手柄的映射配置字符串
SDL_GetGamepadMappingForGUID：通过设备 GUID 获取对应的映射配置字符串
SDL_GetGamepadMappingForID：通过游戏手柄ID获取映射配置字符串
SDL_GetGamepadMappings：获取当前所有已加载的游戏手柄映射配置
SDL_GetGamepadName：获取已打开游戏手柄的设备名称
SDL_GetGamepadNameForID：通过游戏手柄ID获取设备名称
SDL_GetGamepadPath：获取已打开游戏手柄的系统路径
SDL_GetGamepadPathForID：通过游戏手柄ID获取设备系统路径
SDL_GetGamepadPlayerIndex：获取游戏手柄的玩家索引
SDL_GetGamepadPlayerIndexForID：通过游戏手柄ID获取玩家索引
SDL_GetGamepadPowerInfo：获取游戏手柄的电源信息（供电方式、电量百分比）
SDL_GetGamepadProduct：获取游戏手柄的产品ID（PID）
SDL_GetGamepadProductForID：通过游戏手柄ID获取产品ID
SDL_GetGamepadProductVersion：获取游戏手柄的产品版本号
SDL_GetGamepadProductVersionForID：通过游戏手柄ID获取产品版本号
SDL_GetGamepadProperties：获取游戏手柄的属性集合（支持的功能：震动、LED、触摸板等）
SDL_GetGamepads：枚举系统中所有已连接的游戏手柄（返回ID列表及数量）
SDL_GetGamepadSensorData：获取游戏手柄传感器的最新数据（陀螺仪/加速度计数值）
SDL_GetGamepadSensorDataRate：获取游戏手柄传感器的数据更新频率（Hz）
SDL_GetGamepadSerial：获取游戏手柄的序列号（部分设备支持）
SDL_GetGamepadSteamHandle：获取游戏手柄对应的 Steam 句柄（Steam 平台专用）
SDL_GetGamepadStringForAxis：将 SDL_GamepadAxis 枚举值转换为可读字符串（如 "leftx"）
SDL_GetGamepadStringForButton：将 SDL_GamepadButton 枚举值转换为可读字符串（如 "a"）
SDL_GetGamepadStringForType：将 SDL_GamepadType 枚举值转换为可读字符串（如 "xbox360"）
SDL_GetGamepadTouchpadFinger：获取游戏手柄触摸板上指定手指的位置/压力信息
SDL_GetGamepadType：获取游戏手柄的类型（Xbox/PS/Switch 等）
SDL_GetGamepadTypeForID：通过游戏手柄ID获取设备类型
SDL_GetGamepadTypeFromString：将字符串（如 "ps4"）转换为 SDL_GamepadType 枚举值
SDL_GetGamepadVendor：获取游戏手柄的厂商ID（VID）
SDL_GetGamepadVendorForID：通过游戏手柄ID获取厂商ID
SDL_GetNumGamepadTouchpadFingers：获取游戏手柄指定触摸板支持的最大同时触摸手指数量
SDL_GetNumGamepadTouchpads：获取游戏手柄的触摸板数量
SDL_GetRealGamepadType：获取游戏手柄的实际硬件类型（区分虚拟/真实设备）
SDL_GetRealGamepadTypeForID：通过游戏手柄ID获取实际硬件类型
SDL_HasGamepad：检查系统是否连接了至少一个游戏手柄（返回布尔值）
SDL_IsGamepad：检查指定ID的设备是否为标准化游戏手柄（而非普通摇杆）
SDL_OpenGamepad：打开指定ID的游戏手柄设备（返回 SDL_Gamepad 指针）
SDL_ReloadGamepadMappings：重新加载所有游戏手柄映射配置（支持热更新）
SDL_RumbleGamepad：启用游戏手柄的全局震动（设置左右电机强度和持续时间）
SDL_RumbleGamepadTriggers：启用游戏手柄扳机键的震动（仅部分设备支持）
SDL_SendGamepadEffect：发送自定义震动效果到游戏手柄（如特定的震动模式）
SDL_SetGamepadEventsEnabled：启用/禁用游戏手柄事件（禁用后不再接收手柄相关事件）
SDL_SetGamepadLED：设置游戏手柄LED灯的颜色（RGB值，部分设备支持）
SDL_SetGamepadMapping：为指定GUID的设备设置映射配置字符串
SDL_SetGamepadPlayerIndex：设置游戏手柄的玩家索引
SDL_SetGamepadSensorEnabled：启用/禁用游戏手柄的指定传感器
SDL_UpdateGamepads：强制更新所有游戏手柄的状态（SDL 内部自动调用，一般无需手动调用）

数据类型

SDL_Gamepad：游戏手柄设备句柄类型（标识已打开的标准化游戏手柄）

结构体

SDL_GamepadBinding：游戏手柄绑定关系结构体（存储标准化按键/轴与硬件标识的映射）

枚举

SDL_GamepadAxis：游戏手柄标准化轴枚举（如 SDL_GAMEPAD_AXIS_LEFTX 左摇杆X轴、SDL_GAMEPAD_AXIS_RIGHTY 右摇杆Y轴）
SDL_GamepadBindingType：游戏手柄绑定类型枚举（轴/按键/方向键等）
SDL_GamepadButton：游戏手柄标准化按键枚举（如 SDL_GAMEPAD_BUTTON_A A键、SDL_GAMEPAD_BUTTON_START 开始键）
SDL_GamepadButtonLabel：游戏手柄按键标签枚举（适配 Xbox/PS 手柄的按键标识差异）
SDL_GamepadType：游戏手柄类型枚举（SDL_GAMEPAD_TYPE_XBOX360、SDL_GAMEPAD_TYPE_PS4 等）

宏

（无）

FreeBASIC 示例代码

' 引入 SDL 相关声明（需确保 FreeBASIC 已链接 SDL3 库）
#Include "SDL.bi"

' 辅助函数：打印游戏手柄基础信息
Sub PrintGamepadInfo(ByVal gamepad As SDL_Gamepad Ptr)
    If (gamepad = NULL) Then Return

    Dim As ZString Ptr name = SDL_GetGamepadName(gamepad)
    Dim As SDL_JoystickID padID = SDL_GetGamepadID(gamepad)
    Dim As SDL_GamepadType padType = SDL_GetGamepadType(gamepad)
    Dim As ZString Ptr typeStr = SDL_GetGamepadStringForType(padType)

    ' 硬件信息
    Dim As Uint16 vendor = SDL_GetGamepadVendor(gamepad)
    Dim As Uint16 product = SDL_GetGamepadProduct(gamepad)

    SDL_LogInfo(SDL_LOG_CATEGORY_INPUT, "==== 游戏手柄信息 ====")
    SDL_LogInfo(SDL_LOG_CATEGORY_INPUT, "ID：%d | 名称：%s | 类型：%s", padID, name, typeStr)
    SDL_LogInfo(SDL_LOG_CATEGORY_INPUT, "厂商ID：0x%X | 产品ID：0x%X", vendor, product)

    ' 检查可选功能
    Dim As SDL_GamepadProperties props = SDL_GetGamepadProperties(gamepad)
    SDL_LogInfo(SDL_LOG_CATEGORY_INPUT, "支持震动：%s | 支持LED：%s | 支持触摸板：%s", _
        IIf(props.has_rumble, "是", "否"), _
        IIf(props.has_led, "是", "否"), _
        IIf(SDL_GetNumGamepadTouchpads(gamepad) > 0, "是", "否"))

    If (name <> NULL) Then SDL_free(name)
    If (typeStr <> NULL) Then SDL_free(typeStr)
End Sub

' 辅助函数：处理游戏手柄输入（标准化按键/轴）
Sub HandleGamepadInput(ByVal gamepad As SDL_Gamepad Ptr)
    If (gamepad = NULL) Then Return

    ' 处理左摇杆移动（标准化轴）
    Static As Integer lastLX = 0, lastLY = 0
    Dim As Sint16 lx = SDL_GetGamepadAxis(gamepad, SDL_GAMEPAD_AXIS_LEFTX)
    Dim As Sint16 ly = SDL_GetGamepadAxis(gamepad, SDL_GAMEPAD_AXIS_LEFTY)

    ' 死区处理（过滤硬件漂移）
    Const DEADZONE = 8000
    If (Abs(lx) < DEADZONE) Then lx = 0
    If (Abs(ly) < DEADZONE) Then ly = 0

    If (lx <> lastLX Or ly <> lastLY) Then
        If (lx = 0 And ly = 0) Then
            SDL_LogInfo(SDL_LOG_CATEGORY_GAME, "左摇杆：居中")
        Else
            ' 归一化轴值（-1.0 ~ 1.0）
            Dim As Double normLX = lx / 32767.0
            Dim As Double normLY = ly / 32767.0
            SDL_LogInfo(SDL_LOG_CATEGORY_GAME, "左摇杆：X=%.2f, Y=%.2f", normLX, normLY)
        End If
        lastLX = lx
        lastLY = ly
    End If

    ' 检查标准化按键（A键按下触发跳跃）
    Static As Boolean aPressed = False
    Dim As Integer aState = SDL_GetGamepadButton(gamepad, SDL_GAMEPAD_BUTTON_A)
    If (aState And Not aPressed) Then
        SDL_LogInfo(SDL_LOG_CATEGORY_GAME, "按下 A 键：跳跃！")
        ' 触发震动反馈
        SDL_RumbleGamepad(gamepad, 0.3 * 0xFFFF, 0.7 * 0xFFFF, 200)
    End If
    aPressed = (aState <> 0)

    ' 检查右扳机键（RT）
    Static As Integer lastRT = 0
    Dim As Sint16 rt = SDL_GetGamepadAxis(gamepad, SDL_GAMEPAD_AXIS_TRIGGERRIGHT)
    If (rt > DEADZONE And rt <> lastRT) Then
        Dim As Double normRT = rt / 32767.0
        SDL_LogInfo(SDL_LOG_CATEGORY_GAME, "右扳机键：%.2f（开火强度）", normRT)
        lastRT = rt
    End If
End Sub

' 主程序
Dim As SDL_Window Ptr window = NULL
Dim As SDL_Gamepad Ptr gamepad = NULL
Dim As SDL_JoystickID Ptr padIDs = NULL
Dim As Integer padCount = 0
Dim As SDL_Event evt
Dim As Boolean quit = False

' 1. 初始化 SDL（必须包含 GAMEPAD 标志）
If (SDL_Init(SDL_INIT_VIDEO Or SDL_INIT_GAMEPAD) < 0) Then
    SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "SDL 初始化失败：%s", SDL_GetError())
    End 1
End If

' 2. 创建窗口
window = SDL_CreateWindow("SDL 游戏手柄示例", _
    SDL_WINDOWPOS_CENTERED, SDL_WINDOWPOS_CENTERED, _
    800, 600, SDL_WINDOW_SHOWN)
If (window = NULL) Then
    SDL_LogError(SDL_LOG_CATEGORY_APPLICATION, "创建窗口失败：%s", SDL_GetError())
    SDL_Quit()
    End 1
End If

' 3. 枚举并打开游戏手柄
If (SDL_HasGamepad()) Then
    padCount = SDL_GetGamepads(0, NULL)
    If (padCount > 0) Then
        padIDs = Callocate(padCount * SizeOf(SDL_JoystickID))
        padCount = SDL_GetGamepads(padCount, padIDs)
        SDL_LogInfo(SDL_LOG_CATEGORY_INPUT, "检测到 %d 个游戏手柄", padCount)

        ' 打开第一个游戏手柄
        If (SDL_IsGamepad(padIDs[0])) Then
            gamepad = SDL_OpenGamepad(padIDs[0])
            If (gamepad <> NULL) Then
                PrintGamepadInfo(gamepad)
                SDL_SetGamepadEventsEnabled(SDL_TRUE)

                ' 启用陀螺仪（如果支持）
                If (SDL_GamepadHasSensor(gamepad, SDL_SENSOR_GYROSCOPE)) Then
                    SDL_SetGamepadSensorEnabled(gamepad, SDL_SENSOR_GYROSCOPE, SDL_TRUE)
                    SDL_LogInfo(SDL_LOG_CATEGORY_INPUT, "已启用陀螺仪传感器")
                End If
            Else
                SDL_LogError(SDL_LOG_CATEGORY_INPUT, "打开游戏手柄失败：%s", SDL_GetError())
            End If
        Else
            SDL_LogWarn(SDL_LOG_CATEGORY_INPUT, "设备 %d 不是标准化游戏手柄", padIDs[0])
        End If
    End If
Else
    SDL_LogWarn(SDL_LOG_CATEGORY_INPUT, "系统未检测到游戏手柄")
End If

SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "=== SDL 游戏手柄示例 ===")
SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "手柄操作：左摇杆移动 / A键跳跃 / RT键开火 | F1：打印手柄状态 | ESC：退出")

' 4. 主循环
While (Not quit)
    ' 每帧处理游戏手柄输入
    If (gamepad <> NULL And SDL_GamepadConnected(gamepad)) Then
        HandleGamepadInput(gamepad)

        ' 读取陀螺仪数据（如果启用）
        If (SDL_GamepadSensorEnabled(gamepad, SDL_SENSOR_GYROSCOPE)) Then
            Dim As Float sensorData(3)
            If (SDL_GetGamepadSensorData(gamepad, SDL_SENSOR_GYROSCOPE, @sensorData[0], 3) = 0) Then
                Static As Integer frame = 0
                frame += 1
                If (frame Mod 60 = 0) Then ' 每秒打印一次
                    SDL_LogInfo(SDL_LOG_CATEGORY_INPUT, _
                        "陀螺仪数据：X=%.2f, Y=%.2f, Z=%.2f", _
                        sensorData[0], sensorData[1], sensorData[2])
                End If
            End If
        End If
    End If

    ' 处理事件队列
    While (SDL_PollEvent(@evt))
        Select Case evt.type
            Case SDL_QUITEVENT
                quit = True

            ' 键盘事件
            Case SDL_EVENT_KEY_DOWN
                Select Case evt.key.scancode
                    Case SDL_SCANCODE_ESCAPE
                        SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "按下 ESC，退出程序")
                        quit = True

                    ' F1：重新打印手柄信息
                    Case SDL_SCANCODE_F1
                        If (gamepad <> NULL) Then
                            PrintGamepadInfo(gamepad)
                        End If

                    ' F2：设置手柄LED颜色（红色）
                    Case SDL_SCANCODE_F2
                        If (gamepad <> NULL) Then
                            Dim As SDL_GamepadProperties props = SDL_GetGamepadProperties(gamepad)
                            If (props.has_led) Then
                                SDL_SetGamepadLED(gamepad, 255, 0, 0)
                                SDL_LogInfo(SDL_LOG_CATEGORY_INPUT, "设置手柄LED为红色")
                            Else
                                SDL_LogWarn(SDL_LOG_CATEGORY_INPUT, "该手柄不支持LED灯")
                            End If
                        End If
                End Select

            ' 游戏手柄插拔事件
            Case SDL_EVENT_GAMEPAD_ADDED
                SDL_LogInfo(SDL_LOG_CATEGORY_INPUT, "游戏手柄已连接，ID：%d", evt.cdevice.which)
                ' 自动打开新连接的手柄
                If (gamepad = NULL And SDL_IsGamepad(evt.cdevice.which)) Then
                    gamepad = SDL_OpenGamepad(evt.cdevice.which)
                    If (gamepad <> NULL) Then
                        PrintGamepadInfo(gamepad)
                    End If
                End If

            Case SDL_EVENT_GAMEPAD_REMOVED
                SDL_LogInfo(SDL_LOG_CATEGORY_INPUT, "游戏手柄已断开，ID：%d", evt.cdevice.which)
                If (gamepad <> NULL And SDL_GetGamepadID(gamepad) = evt.cdevice.which) Then
                    SDL_CloseGamepad(gamepad)
                    gamepad = NULL
                End If

            ' 游戏手柄按键事件（标准化）
            Case SDL_EVENT_GAMEPAD_BUTTON_DOWN
                Dim As ZString Ptr btnStr = SDL_GetGamepadStringForButton(evt.cbutton.button)
                SDL_LogInfo(SDL_LOG_CATEGORY_INPUT, "手柄按键 %s 按下（设备ID：%d）", btnStr, evt.cbutton.which)
                SDL_free(btnStr)

            Case SDL_EVENT_GAMEPAD_BUTTON_UP
                Dim As ZString Ptr btnStr = SDL_GetGamepadStringForButton(evt.cbutton.button)
                SDL_LogInfo(SDL_LOG_CATEGORY_INPUT, "手柄按键 %s 释放（设备ID：%d）", btnStr, evt.cbutton.which)
                SDL_free(btnStr)

            ' 游戏手柄轴事件（标准化）
            Case SDL_EVENT_GAMEPAD_AXIS_MOTION
                Dim As ZString Ptr axisStr = SDL_GetGamepadStringForAxis(evt.caxis.axis)
                SDL_LogInfo(SDL_LOG_CATEGORY_INPUT, "手柄轴 %s 移动：%d（设备ID：%d）", _
                    axisStr, evt.caxis.value, evt.caxis.which)
                SDL_free(axisStr)
        End Select
    Wend

    SDL_Delay(10)
Wend

' 5. 清理资源
If (gamepad <> NULL) Then
    SDL_CloseGamepad(gamepad)
End If
If (padIDs <> NULL) Then
    Deallocate(padIDs)
End If
SDL_DestroyWindow(window)
SDL_Quit()

SDL_LogInfo(SDL_LOG_CATEGORY_APPLICATION, "程序正常退出")
End Sub

核心知识点补充

标准化轴/按键枚举（游戏开发高频使用）：	轴枚举	说明	按键枚举
SDL_GAMEPAD_AXIS_LEFTX	左摇杆X轴	SDL_GAMEPAD_BUTTON_A	A 键（确认）
SDL_GAMEPAD_AXIS_LEFTY	左摇杆Y轴	SDL_GAMEPAD_BUTTON_B	B 键（取消）
SDL_GAMEPAD_AXIS_RIGHTX	右摇杆X轴	SDL_GAMEPAD_BUTTON_X	X 键
SDL_GAMEPAD_AXIS_RIGHTY	右摇杆Y轴	SDL_GAMEPAD_BUTTON_Y	Y 键
SDL_GAMEPAD_AXIS_TRIGGERLEFT	左扳机键	SDL_GAMEPAD_BUTTON_START	开始键
SDL_GAMEPAD_AXIS_TRIGGERRIGHT	右扳机键	SDL_GAMEPAD_BUTTON_BACK	返回键

死区处理必要性：
- 物理摇杆存在硬件漂移，即使未触碰也会有微小数值；
- 通常设置 8000~10000 的死区阈值，低于阈值视为 0；
- 死区值需根据手柄硬件调整，避免操作不灵敏。
跨平台适配：
- SDL 自动适配 Xbox/PS/Switch 手柄的按键标签差异；
- 通过 SDL_GetGamepadButtonLabel 获取平台化的按键标识；
- Steam 平台需优先初始化 Steam API，确保手柄功能正常。

总结

核心优势：
- 标准化输入标识，无需关心硬件底层的按键/轴编号；
- 内置主流手柄配置，开箱即用，大幅降低适配成本；
- 支持震动、LED、传感器等高级功能的统一调用接口；
使用建议：
- 绝大多数游戏场景优先使用 Gamepad API，而非底层 Joystick API；
- 必须支持热插拔，适配手柄动态连接/断开；
- 轴输入需做死区处理，提升操作手感；
关键流程：
- 初始化（SDL_INIT_GAMEPAD）→ 枚举设备 → 检查是否为标准化手柄 → 打开手柄 → 处理标准化事件/查询状态 → 关闭手柄。