Skip to main content

IGameInput::FindDeviceFromId

識別子に基づいてデバイスを取得します。

構文

パラメーター

value   _In_
型: APP_LOCAL_DEVICE_ID*
デバイス用にシステムが生成した ID。 device   _COM_Outptr_
型: IGameInputDevice**
返されるデバイス。

戻り値

型: HRESULT 関数の結果。

解説

取得された IGameInputDevice インスタンスは、IGameInput::GetCurrentReading のようなポーリング API や IGameInput::RegisterReadingCallback のようなイベント ベース API (入力を取得するため) でフィルターとして使用したり、デバイス固有の情報と機能にアクセスするために直接使用することができます。指定された識別子が既知の GameInput デバイス オブジェクトのいずれとも一致しない場合、GetDeviceFrom* メソッドは NULL ポインターを返します。これらのメソッドは呼び出し元プロセス内のローカル状態を照会して迅速に返るため、時間に敏感なコンテキストからでも安全に呼び出すことができます。

要件

ヘッダー: GameInput.h Input API の概要
IGameInput
IGameInputDevice
IGameInput::GetCurrentReading
IGameInput::RegisterReadingCallback

バージョン履歴

最終更新日 2026年8月13日