Sintaxe
Parâmetros
infoArrayCount _In_Tipo: uint32_t Número de elementos em infoArray. Para recuperar todos os relatórios de recurso, passe o valor retornado por GetFeatureReportCount. infoArray _Out_writes_to_opt_(infoArrayCount, return)
Tipo: GameInputRawDeviceReportInfo* Ponteiro para uma matriz que recebe uma estrutura por relatório de recurso. 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 recurso no dispositivo, ou 0 se infoArray fornullptr ou se o dispositivo não tiver relatórios de recurso.
Comentários
Cada elemento é uma estrutura GameInputRawDeviceReportInfo cujo membrokind é GameInputRawFeatureReport, 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 GetFeatureReportCount para obter o número de relatórios de recurso, aloque uma matriz desse tamanho e, em seguida, chame GetFeatureReportInfo para preenchê-la. Se infoArrayCount for menor que o número de relatórios de recurso, somente os primeiros infoArrayCount elementos serão gravados. Os relatórios de recurso 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 GetRawDeviceFeature para ler o relatório, ou de CreateRawDeviceReport, junto com GameInputRawFeatureReport, para criar um relatório que você pode enviar com SetRawDeviceFeature. O membro size fornece o número de bytes de dados do relatório.
O exemplo a seguir mostra como recuperar os relatórios de recurso de um dispositivo.
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 GameInputGetFeatureReportCount
GameInputRawDeviceReportInfo
GameInputRawDeviceReportKind
IGameInputRawDeviceReport
GetRawDeviceFeature
SetRawDeviceFeature
CreateRawDeviceReport
Tópicos avançados do GameInput
IGameInputDevice
