Skip to main content

XUserFindControllerForUserWithUiAsync

Mostra uma caixa de diálogo que solicitará ao usuário que ligue e identifique qual controle deseja usar.

Sintaxe

Parâmetros

user   _In_
Tipo: XUserHandle
O XUserHandle do usuário para o qual encontrar um controle. async   _In_
Tipo: XAsyncBlock*
Um XAsyncBlock para sondar o status da chamada e recuperar os resultados da chamada.

Valor retornado

Tipo: HRESULT Código de sucesso ou erro HRESULT. Para obter uma lista de códigos de erro, consulte Códigos de erro.

Comentários

Na área de trabalho, esta função não mostrará a interface do usuário. Para obter os resultados de qual controle o usuário selecionou, há algumas opções.
  1. Chame XUserFindControllerForUserWithUiResult. Isso retornará a ID do dispositivo do controle agora vinculado.
  2. Obtenha o resultado do retorno de chamada XUserDeviceAssociationChangedCallback, que ocorrerá quando o usuário tiver selecionado o novo controle.

Requisitos

Cabeçalho: XUser.h Biblioteca: xgameruntime.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX Series

Confira também

XUser
Lidando com a perda do controle (tópico sob NDA)
Last modified on October 6, 2026