Share via


Função XInputSetState (xinput.h)

Envia dados para um controlador conectado. Essa função é usada para ativar a função de vibração de um controlador.

Sintaxe

DWORD XInputSetState(
  [in]      DWORD            dwUserIndex,
  [in, out] XINPUT_VIBRATION *pVibration
);

Parâmetros

[in] dwUserIndex

Índice do controlador do usuário. Pode ser um valor de 0 a 3. Para obter informações sobre como esse valor é determinado e como o valor é mapeado para indicadores no controlador, consulte Vários controladores.

[in, out] pVibration

Ponteiro para uma estrutura XINPUT_VIBRATION que contém as informações de vibração a serem enviadas ao controlador.

Retornar valor

Se a função for bem-sucedida, o valor retornado será ERROR_SUCCESS.

Se o controlador não estiver conectado, o valor retornado será ERROR_DEVICE_NOT_CONNECTED.

Se a função falhar, o valor retornado será um código de erro definido em WinError.h. A função não usa SetLastError para definir o código de último erro do thread de chamada.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho xinput.h
Biblioteca Xinput.lib; Xinput9_1_0.lib
DLL Xinput1_4.dll; Xinput9_1_0.dll

Confira também

XINPUT_VIBRATION

Funções XInput

XInputGetState