IGameInput::FindDeviceFromId

基于某一设备的 DeviceID 检索该设备。

语法

HRESULT FindDeviceFromId(  
         const APP_LOCAL_DEVICE_ID* value,  
         IGameInputDevice** device  
)  

参数

value _In_
类型:APP_LOCAL_DEVICE_ID*

设备的系统生成的 ID。

device _COM_Outptr_
类型:IGameInputDevice**

返回的设备。

返回值

类型:HRESULT

函数结果。

备注

一旦获取,IGameInputDevice 实例就可以用作 IGameInput::GetCurrentReading 之类的轮询 API 或者 IGameInput::RegisterReadingCallback(用于检索输入)之类的基于事件的 API 中的筛选器,或者直接用于访问设备特定的信息和功能。 如果提供的标识符无法与任何已知的 GameInput 设备对象匹配,则 GetDeviceFrom* 方法将返回一个 NULL 指针。 这些方法询问调用进程内的本地状态并且快速返回,这样它们可以安全地从时间敏感上下文调用。

要求

头文件:GameInput.h

库:xgameruntime.lib

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

另请参阅

输入 API 概述
IGameInput
IGameInputDevice
IGameInput::GetCurrentReading
IGameInput::RegisterReadingCallback