Skip to main content

IGameInput::FindDeviceFromId

Recupera um dispositivo com base no identificador dele.

Sintaxe

Parâmetros

value   _In_
Tipo: APP_LOCAL_DEVICE_ID*
ID gerada pelo sistema para o dispositivo. device   _COM_Outptr_
Tipo: IGameInputDevice**
O dispositivo retornado.

Valor retornado

Tipo: HRESULT Resultado da função.

Comentários

Depois de obtida, a instância de IGameInputDevice pode ser usada como filtro nas APIs de sondagem, como IGameInput::GetCurrentReading, ou nas APIs baseadas em eventos, como IGameInput::RegisterReadingCallback (para recuperar a entrada), ou ser usada diretamente para acessar informações e recursos específicos do dispositivo. Se o identificador fornecido não puder ser correspondido a nenhum objeto de dispositivo conhecido do GameInput, os métodos GetDeviceFrom* retornarão um ponteiro NULL. Esses métodos consultam o estado local dentro do processo de chamada e retornam rapidamente, portanto, é seguro chamá-los de contextos sensíveis ao tempo.

Requisitos

Cabeçalho: GameInput.h Visão geral da API de entrada
IGameInput
IGameInputDevice
IGameInput::GetCurrentReading
IGameInput::RegisterReadingCallback

Histórico de versões

Last modified on October 6, 2026