IGameInput::FindDeviceFromObject

Note

This function is not yet implemented.

Retrieves a connected IGameInputDevice interface based on a matching object.

Syntax

HRESULT FindDeviceFromObject(  
         IUnknown* value,  
         IGameInputDevice** device  
)  

Parameters

value   _In_
Type: IUnknown*

Object to match with the IGameInputDevice instance.

device   _COM_Outptr_
Type: IGameInputDevice**

Returned IGameInputDevice interface.

Return value

Type: HRESULT

Returns E_NOTIMPL.

Remarks

After it is obtained, the IGameInputDevice instance is used as a filter in polling or event-based APIs (to retrieve input), or used directly to access device-specific information and features.

This method retrieves a connected IGameInputDevice interface based on a matching object. IGameInputDevice is used as a filter in the polling or event-based APIs (to retrieve input), or used directly to access device-specific information and features. If the specified object cannot be matched with any known GameInput device objects, this method returns a NULL pointer. The method queries the local state within the calling process and returns quickly, so it is safe to call from time-sensitive contexts.

Requirements

Header: GameInput.h

Library: xgameruntime.lib

Supported platforms: Windows, Xbox One family consoles and Xbox Series consoles

See also

Advanced GameInput topics
Overview of GameInput
IGameInput