Partager via


IGameInput::FindDeviceFromPlatformHandle

Note

This function is not yet implemented.

Retrieves a connected IGameInputDevice interface based on a matching platform handle.

Syntax

HRESULT FindDeviceFromPlatformHandle(  
         HANDLE value,  
         IGameInputDevice** device  
)  

Parameters

value   _In_
Type: HANDLE

Platform handle to match.

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. If the specified handle 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