Sintaxe
Parâmetros
infoArrayCount _In_Tipo: uint32_t Número de elementos em infoArray. Para recuperar todos os motores de force feedback, passe o valor retornado por GetForceFeedbackMotorCount. infoArray _Out_writes_to_opt_(infoArrayCount, return)
Tipo: GameInputForceFeedbackMotorInfo* Ponteiro para uma matriz que recebe uma estrutura por motor de force feedback. Pode ser
nullptr; nesse caso, nada é gravado e o método retorna 0.
Valor retornado
Tipo: uint32_t O número de elementos gravados em infoArray. Esse é o menor valor entre infoArrayCount e o número de motores de force feedback no dispositivo, ou 0 se infoArray fornullptr ou se o dispositivo não tiver motores de force feedback.
Comentários
Cada elemento é uma estrutura GameInputForceFeedbackMotorInfo que descreve os eixos acionados pelo motor correspondente e os tipos de efeito de force feedback aos quais ele dá suporte. Chame GetForceFeedbackMotorCount para obter o número de motores de force feedback, aloque uma matriz desse tamanho e, em seguida, chameGetForceFeedbackMotorInfo para preenchê-la. Se infoArrayCount for menor que o número de motores de force feedback, somente os primeiros infoArrayCount elementos serão gravados. Os motores de force feedback de um dispositivo não mudam enquanto o dispositivo está conectado, portanto você pode consultá-los uma vez e armazenar o resultado em cache.
O elemento i da matriz de informações descreve o motor que tem o índice de motor i. Use esse índice como o parâmetro motorIndex de CreateForceFeedbackEffect, IsForceFeedbackMotorPoweredOn e SetForceFeedbackMotorGain.
O exemplo a seguir mostra como recuperar os motores de force feedback de um dispositivo.
forceFeedbackMotorInfo da estrutura GameInputDeviceInfo retornada por IGameInputDevice::GetDeviceInfo.
Requisitos
Cabeçalho: GameInput.h Biblioteca: gameinput.lib Plataformas com suporte: Windows, consoles da família XBOX One e consoles XBOX SeriesConfira também
Visão geral do GameInputGetForceFeedbackMotorCount
GameInputForceFeedbackMotorInfo
CreateForceFeedbackEffect
IsForceFeedbackMotorPoweredOn
SetForceFeedbackMotorGain
Force feedback no GameInput
IGameInputDevice
