IGameInputDevice::GetRawDeviceFeature

Lê um relatório de recurso bruto do dispositivo.

Sintaxe

HRESULT GetRawDeviceFeature(
    uint32_t reportId,
    IGameInputRawDeviceReport** report
);

Parâmetros

reportId _In_
Tipo: uint32_t ID do relatório de recurso a ser lido. Deve corresponder ao membro id de um dos relatórios retornados por GetFeatureReportInfo. report _COM_Outptr_
Tipo: IGameInputRawDeviceReport** Recebe um novo objeto IGameInputRawDeviceReport que contém os dados do relatório de recurso lidos do dispositivo. Definido como nullptr em caso de falha.

Valor retornado

Tipo: HRESULT Retorna S_OK em caso de êxito. Retorna E_NOTFOUND se o dispositivo não definir um relatório de recurso com o ID especificado e GAMEINPUT_E_AGGREGATE_OPERATION_NOT_SUPPORTED se o dispositivo for um dispositivo agregado. Retorna outros códigos de erro se o relatório não puder ser lido do dispositivo.

Comentários

O método GetRawDeviceFeature solicita ao dispositivo o conteúdo atual de um relatório de recurso e o retorna em um novo objeto IGameInputRawDeviceReport. O membro kind da estrutura GameInputRawDeviceReportInfo do relatório é GameInputRawFeatureReport, e o tamanho dos dados corresponde ao membro size do elemento correspondente retornado por GetFeatureReportInfo. Leia os dados chamando GetRawDataSize e IGameInputRawDeviceReport::GetRawData. Use GetFeatureReportCount e GetFeatureReportInfo para descobrir quais relatórios de recurso um dispositivo define. 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. Ao contrário dos outros métodos de relatório bruto, GetRawDeviceFeature aguarda a resposta do dispositivo antes de retornar; portanto, evite chamá-lo em threads com restrições de tempo, como o thread de renderização ou de sondagem de entrada.

Microsoft::WRL::ComPtr<IGameInputRawDeviceReport> report;
if (SUCCEEDED(device->GetRawDeviceFeature(reportId, &report)))
{
    std::vector<uint8_t> data(report->GetRawDataSize());
    data.resize(report->GetRawData(data.size(), data.data()));
    // Parse the device-specific feature report data...
}

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
SetRawDeviceFeature
GetFeatureReportCount
GetFeatureReportInfo
IGameInputRawDeviceReport
CreateRawDeviceReport
IGameInputDevice

Histórico de versões

Versão	Alterações
v4	Reintroduzido.
v1	Removido.
v0	Introduzido (não implementado).

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::GetRawDeviceFeature (Preterido).

Chat API reference

Developer kit only API reference

Graphics API reference

Input API reference

Lighting API reference

Networking API reference

XBOX PC remote iteration API reference

System API reference

Tools API reference

Windows device portal REST API reference

XBOX services API reference

MicrosoftGame.config reference

Additional pages

Reference

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Confira também

Histórico de versões

Apêndice: versões anteriores

v0

​Sintaxe

​Parâmetros

​Valor retornado

​Comentários

​Requisitos

​Confira também

​Histórico de versões

​Apêndice: versões anteriores

​v0

Sintaxe

Parâmetros

Valor retornado

Comentários

Requisitos

Confira também

Histórico de versões

Apêndice: versões anteriores

v0