Skip to main content

XInputSetStateEx

Envia dados de vibração para o controle especificado. Dá suporte à funcionalidade de vibração de quatro motores dos controles mais recentes.

Sintaxe

Parâmetros

dwUserIndex   _In_
Tipo: DWORD
Índice do jogador associado ao dispositivo; um valor no intervalo de 0 a XUSER_MAX_COUNT - 1. pVibration   _In_
Tipo: XINPUT_VIBRATION_EX*
Ponteiro para um objeto XINPUT_VIBRATION_EX que contém as informações de vibração a serem enviadas ao controle.

Valor retornado

Tipo: DWORD Se a função for bem-sucedida, ela retornará ERROR_SUCCESS. Se o controle não estiver conectado, a função retornará ERROR_DEVICE_NOT_CONNECTED. Se a função falhar, ela retornará um código de erro definido em WinError.h.

Comentários

É seguro chamar essa função mesmo durante uma interação com um controle de dois motores. Qualquer configuração de vibração enviada a XInputSetStateEx para um controle de dois motores será ajustada para garantir que o controle ainda vibre com a melhor aproximação da entrada enviada. Por esse motivo, recomendamos que você chame XInputSetStateEx nas situações em que chamaria XInputSetState. Para obter mais informações, consulte O wrapper XInputOnGameInput.

Requisitos

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

Confira também

Portabilidade do XInput para o GameInput
XInputOnGameInput
Last modified on October 6, 2026