次の方法で共有


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