HidP_GetExtendedAttributes

9/8/2008

Essa função retorna o estendido atributos de um controle HID.

Syntax

NTSTATUS HidP_GetExtendedAttributes(
  HIDP_REPORT_TYPE ReportType,
  USHORT DataIndex,
  PHIDP_PREPARSED_DATA PreparsedData,
  PHIDP_EXTENDED_ATTRIBUTES Attributes,
  PULONG LengthAttributes
);

Parameters

• ReportType
  [no] HIDP_REPORT_TYPE enumerador valor que indica o tipo de relatório HID associado com o controle HID especificado por DataIndex.

• DataIndex
  [no] Índice de dados de controle de HID.

• PreparsedData
  [no] Preparsed dados para o de alto nível coleção que contém o controle especificado.

• Atributos
  [out] Ponteiro para uma reserva Caller-allocated que usa a função para retornar o estendido atributos do controle especificado por DataIndex.

• LengthAttributes
  [in, Out] Na entrada, o tamanho em bytes das Atributos reserva, que deve ser maior ou igual a sizeof (HIDP_EXTENDED_ATTRIBUTES). Na saída, o tamanho em bytes das Atributos reserva.

Return Value

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

Valor	Descrição
HIDP_STATUS_SUCCESS	Função retornado com êxito estendido de controle informações de atributo.
HIDP_STATUS_BUFFER_TOO_SMALL	Atributo reserva não é grande o suficiente para armazenar todos os estendido informações de atributo.
HIDP_STATUS_DATA_INDEX_NOT_FOUND	Especificado índice dados não é válido.

Remarks

HidP_GetExtendedAttributes Retorna uma variável comprimento HIDP_EXTENDED_ATTRIBUTES estrutura in a Atributo reserva. O HIDP_EXTENDED_ATTRIBUTES estendido estrutura atributos contém, na ordem consecutiva, os membros de comprimento fixo NumGlobalUnknowns, Reservado, e GlobalUnknowns, seguido por uma variável matriz de comprimento HIDP_UNKNOWN_TOKEN estruturas. O primeiro membro do token desconhecido matriz está localizado em (PHID_UNKNOWN_TOKEN*)&(Atributos->Dados).

A função retorna quantos bytes do estendido informações de atributo como o Atributo reserva pode conter. Se a reserva é muito pequena, a função truncará as informações retornará. Para determinar o número de símbolos desconhecidos na variável de matriz Comprimento, um chamador pode usar primeiro o Atributos reserva para retornar o valor da NumGlobalUnknowns membro do estendido atributos informações.

Requirements

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

See Also

Reference

HIDP_EXTENDED_ATTRIBUTES
HIDP_REPORT_TYPE
HIDP_UNKNOWN_TOKEN