HidP_GetData

9/8/2008

Essa função retorna uma matriz de HIDP_DATA estruturas para um relatório especificado que identifica os índices dados de todos os botões controle HID atualmente configurado para Ativado (um). Ele também retorna dados índices e dados associado com todos os valores controle HID.

Syntax

NTSTATUS HidP_GetData(
  HIDP_REPORT_TYPE ReportType,
  PHIDP_DATA DataList,
  PULONG DataLength,
  PHIDP_PREPARSED_DATA PreparsedData,
  PCHAR Report,
  ULONG ReportLength
);

Parameters

• ReportType
  [no] HIDP_REPORT_TYPE enumerador valor que indica o tipo de relatório HID localizado na Relatório parâmetro.

• DataList
  [out] Matriz Caller-allocated de HIDP_DATA estruturas que usa a função para retornar informações sobre todos os botões que estão atualmente definidos como On e de dados associado com valores.

• DataLength
  [in, Out] Na entrada, o número de estruturas que o chamador-alocados DataList matriz contém. Na saída, o número de controles para os quais a função pode retornar dados, que inclui todos os botões que estão atualmente definidos como On e todos os valores controle.

• PreparsedData
  [no] Ponteiro para os dados preparsed do de alto nível coleção associado com o relatório HID localizado na Relatório parâmetro.

• Relatório
  [no] Ponteiro para um relatório HID.

• ReportLength
  [no] Tamanho, em bytes, do relatório HID localizado em Relatório, que deve ser igual ao tamanho de relatório para o tipo especificado relatório retornado pelo HidP_GetCaps função da coleção a HIDP_CAPS estrutura.

Return Value

A seguinte tabela mostra os possíveis valores de retorno.

Valor	Descrição
HIDP_STATUS_SUCCESS	Todos os dados controle foi retornado com êxito.
HIDP_STATUS_INVALID_REPORT_TYPE	Tipo de relatório especificado por ReportType não é válido.
HIDP_STATUS_INVALID_PREPARSED_DATA	Preparsed dados especificados por PreparsedData não é válido.
HIDP_STATUS_INVALID_REPORT_LENGTH	Tamanho, em bytes, do relatório HID não é igual ao comprimento especificado da coleção HIDP_CAPS estrutura para o tipo relatório especificado.
HIDP_STATUS_REPORT_DOES_NOT_EXIST	Coleção de nível superior não tem um relatório do tipo especificado.
HIDP_STATUS_BUFFER_TOO_SMALL	DataList matriz é muito pequeno para descrever todos os valores no relatório de HID e todos os botões que estão atualmente definidos como ON.

Remarks

Chamar clientes HID a HidP_MaxDataListLength função para determinar o número máximo possível de HIDP_DATA estruturas que HidP_GetData pode retornar.

HidP_GetData Não retornar dados para uso valor matrizes.

Requirements

Header	hidpi.h
Library	Hidparse_lib.lib
Windows Embedded CE	Windows CE .NET 4.2 and later

See Also

Reference

HIDP_DATA
HidP_MaxDataListLength
HIDP_REPORT_TYPE
HidP_SetData