Compartilhar via

função HidD_GetInputReport (hidsdi.h)

  • Artigo

A rotina HidD_GetInputReport retorna um relatório de entrada de uma coleção de nível superior.

Use essa rotina apenas para obter o estado atual de uma coleção. Se um aplicativo tentar usar essa rotina para obter continuamente relatórios de entrada, os relatórios poderão ser perdidos. Para obter mais informações, consulte Obtendo relatórios HID por aplicativos de modo de usuário.

Sintaxe

BOOLEAN HidD_GetInputReport(
  [in]  HANDLE HidDeviceObject,
  [out] PVOID  ReportBuffer,
  [in]  ULONG  ReportBufferLength
);

Parâmetros

[in] HidDeviceObject

Um identificador aberto para uma coleção de nível superior.

[out] ReportBuffer

Ponteiro para um buffer de relatório de entrada alocado pelo chamador que o chamador usa para especificar uma ID de relatório HID e HidD_GetInputReport usa para retornar o relatório de entrada especificado.

Para obter mais informações sobre esse parâmetro, consulte a seção Comentários.

[in] ReportBufferLength

O tamanho do buffer de relatório em bytes. O buffer de relatório deve ser grande o suficiente para manter o relatório de entrada mais um byte adicional que especifica uma ID de relatório. Se a ID do relatório não for usada, o valor da ID será zero.

Retornar valor

HidD_GetInputReportretornará TRUE se tiver êxito; caso contrário, retornará FALSE. Use GetLastError para obter informações de erro estendidas.

Comentários

O ReportBufferLength correto é especificado pelo membro InputReportByteLength da estrutura HIDP_CAPS de uma coleção de nível superior retornada de HidP_GetCaps chamada.

Antes de chamar a rotina HidD_GetInputReport , o chamador deve fazer o seguinte:

  • Se a coleção de nível superior incluir IDs de relatório, o chamador deverá definir o primeiro byte do parâmetro ReportBuffer como uma ID de relatório diferente de zero.
  • Se a coleção de nível superior não incluir IDs de relatório, o chamador deverá definir o primeiro byte do parâmetro ReportBuffer como zero.

O relatório de entrada é retornado no parâmetro ReportBuffer . Dependendo da ID do relatório, o chamador analisa o relatório chamando uma das seguintes funções:

Para obter um exemplo de como analisar um relatório HID, consulte o aplicativo de exemplo HClient .

Somente aplicativos de modo de usuário podem chamar HidD_GetInputReport. Os drivers no modo kernel podem usar uma solicitação de IOCTL_HID_GET_INPUT_REPORT.

Para obter mais informações, consulte Interpretando relatórios HID.

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows XP e versões posteriores do Windows.
Plataforma de Destino Universal
Cabeçalho hidsdi.h (inclua Hidsdi.h)
Biblioteca Hid.lib
DLL Hid.dll

Confira também