IGameInput：：EnableOemDeviceSupport (v0)

指定调用方想要 GameInput API 在其输入流中公开的即插即用设备。

语法

HRESULT EnableOemDeviceSupport(  
         uint16_t vendorId,  
         uint16_t productId,  
         uint8_t interfaceNumber,  
         uint8_t collectionNumber  
)  

参数

vendorId _In_
类型：uint16_t

要用于标识 OEM 设备的供应商 ID (VID)。

productId _In_
类型：uint16_t

要用于标识 OEM 设备的产品 ID (PID)。

interfaceNumber _In_
类型：uint8_t

USB 接口号（如果适用）。

collectionNumber _In_
类型：uint8_t

HID 集合编号（由 HIDCLASS.sys 分配，若适用）。

返回值

类型：HRESULT

返回 E_NOTIMPL。

备注

使用此方法启用设备可实现对设备的原始访问，例如输入/输出控件 (IOCTL)。 OEM 使用来自此类设备的原始输入报告，并通过自己的 API 图面公开基础数据。

设备由其 VID/PID、USB 接口号（若适用）和 HID 集合编号（由 HIDCLASS.sys 分配，若适用）的组合进行标识。 这是一种稳定的标识方法，与 OEM 设备的固件向其控制的系统呈现自身的方式相关联。

通过 EnableOemDeviceSupport 方法公开的事件仅对请求它们的应用程序可见。 在某给定进程释放对 IGameInput 接口（以及任何其他待定 GameInput 接口）的所有引用之前，OEM 设备保持对该进程的支持。

一个应用程序可支持最多 1024 台不同的 OEM 设备。 如果超出该限制，将导致返回失败 HRESULT。 此方法快速返回结果，而且可安全地从时间敏感上下文进行调用。

要求

头文件：GameInput.h

库：xgameruntime.lib

支持平台：Windows、Xbox One 系列主机和 Xbox Series 主机

另请参阅

高级 GameInput 主题
GameInput 概述
IGameInput