Pular para o conteúdo principal
Recupera as descrições dos relatórios de saída brutos que o dispositivo define.

Sintaxe

Parâmetros

infoArrayCount   _In_
Tipo: uint32_t
Número de elementos em infoArray. Para recuperar todos os relatórios de saída, passe o valor retornado por GetOutputReportCount. infoArray   _Out_writes_to_opt_(infoArrayCount, return)
Tipo: GameInputRawDeviceReportInfo*
Ponteiro para uma matriz que recebe uma estrutura por relatório de saída. 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 relatórios de saída no dispositivo, ou 0 se infoArray for nullptr ou se o dispositivo não tiver relatórios de saída.

Comentários

Cada elemento é uma estrutura GameInputRawDeviceReportInfo cujo membro kind é GameInputRawOutputReport, cujo membro id é o ID do relatório definido pelo dispositivo e cujo membro size é o tamanho dos dados do relatório em bytes. Chame GetOutputReportCount para obter o número de relatórios de saída, aloque uma matriz desse tamanho e, em seguida, chame GetOutputReportInfo para preenchê-la. Se infoArrayCount for menor que o número de relatórios de saída, somente os primeiros infoArrayCount elementos serão gravados. Os relatórios de saída de um dispositivo não mudam enquanto o dispositivo está conectado, portanto você pode consultá-los uma vez e armazenar o resultado em cache. Use o membro id de um elemento como o parâmetro reportId de CreateRawDeviceReport, junto com GameInputRawOutputReport, para criar um relatório de saída que você pode enviar com SendRawDeviceOutput. O membro size fornece o número de bytes de dados do relatório que o dispositivo espera. O exemplo a seguir mostra como recuperar os relatórios de saída de um dispositivo.
No GameInput v3 e anteriores, essas informações estavam disponíveis no membro outputReportInfo 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 Series

Confira também

Visão geral do GameInput
GetOutputReportCount
GameInputRawDeviceReportInfo
GameInputRawDeviceReportKind
IGameInputRawDeviceReport
CreateRawDeviceReport
SendRawDeviceOutput
Tópicos avançados do GameInput
IGameInputDevice

Histórico de versões

Última modificação em 6 de novembro de 2026