Pular para o conteúdo principal
Envia um relatório de recurso bruto para o dispositivo.

Sintaxe

Parâmetros

report   _In_
Tipo: IGameInputRawDeviceReport*
O relatório de recurso a ser enviado. Crie-o chamando CreateRawDeviceReport com GameInputRawFeatureReport e preencha-o chamando IGameInputRawDeviceReport::SetRawData.

Valor retornado

Tipo: HRESULT Retorna S_OK se o relatório tiver sido enviado ao dispositivo. Retorna GAMEINPUT_E_AGGREGATE_OPERATION_NOT_SUPPORTED se o dispositivo for um dispositivo agregado ou outro código de erro se o relatório não puder ser enviado.

Comentários

O método SetRawDeviceFeature grava um relatório de recurso no dispositivo. O ID do relatório é obtido da estrutura GameInputRawDeviceReportInfo do relatório, e a carga são os dados definidos com IGameInputRawDeviceReport::SetRawData. Use GetFeatureReportCount e GetFeatureReportInfo para descobrir quais relatórios de recurso um dispositivo define e qual é o tamanho de cada um. Atualmente, os relatórios de recurso são expostos para dispositivos HID. Para dispositivos HID, o primeiro byte dos dados do relatório é o ID do relatório. SetRawDeviceFeature enfileira o relatório para entrega e retorna sem aguardar que o dispositivo o processe. Um valor retornado de êxito significa que o relatório foi enviado, não que o dispositivo o aceitou. Para confirmar o novo estado, leia o relatório novamente chamando GetRawDeviceFeature.
Para casos de uso intermediários e avançados da API do GameInput, confira Tópicos avançados do GameInput.

Requisitos

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

Confira também

Visão geral do GameInput
GetRawDeviceFeature
GetFeatureReportCount
GetFeatureReportInfo
CreateRawDeviceReport
IGameInputRawDeviceReport
IGameInputDevice

Histórico de versões

Apêndice: versões anteriores

v0

No GameInput v0, este método foi declarado com a mesma assinatura, mas não foi implementado. Para obter mais informações, confira IGameInputDevice::SetRawDeviceFeature (Preterido).
Última modificação em 6 de novembro de 2026