função HidP_GetExtendedAttributes (hidpi.h)

A rotina HidP_GetExtendedAttributes retorna os atributos estendidos de um controle HID.

Sintaxe

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

Parâmetros

[in] ReportType

Especifica um valor HIDP_REPORT_TYPE enumerador que indica o tipo de relatório HID associado ao controle HID especificado por DataIndex.

[in] DataIndex

Especifica o índice de dados do controle HID.

[in] PreparsedData

Especifica os dados pré-preparados para a coleção de nível superior que contém o controle especificado.

[out] Attributes

Ponteiro para um buffer alocado pelo chamador que a rotina usa para retornar os atributos estendidos do controle especificado por DataIndex.

[in, out] LengthAttributes

Especifica o tamanho, em bytes, do buffer Atributos (que deve ser maior ou igual a sizeof(HIDP_EXTENDED_ATTRIBUTES).

Retornar valor

HidP_GetExtendedAttributes retorna um dos seguintes valores de status:

Código de retorno	Descrição
HIDP_STATUS_SUCCESS	A rotina retornou com êxito todas as informações de atributo estendido do controle.
HIDP_STATUS_BUFFER_TOO_SMALL	O buffer atributo não era grande o suficiente para conter todas as informações de atributo estendido.
HIDP_STATUS_DATA_INDEX_NOT_FOUND	O índice de dados especificado não é válido.

Comentários

HidP_GetExtendedAttributes retorna uma estrutura HIDP_EXTENDED_ATTRIBUTES de comprimento variável no buffer atributo . A estrutura de atributos estendidos contém, em ordem consecutiva, os membros de comprimento fixo (NumGlobalUnknowns, Reserved e GlobalUnknowns) seguidos por uma matriz de comprimento variável de estruturas HIDP_UNKNOWN_TOKEN . O primeiro membro da matriz de token desconhecido está localizado em (PHIDP_UNKNOWN_TOKEN*)&(Attributes-Data>).

A rotina retorna tantos bytes das informações de atributo estendido quanto o buffer de atributo pode conter. Se o buffer for muito pequeno, a rotina truncará as informações retornadas. Para determinar o número de tokens desconhecidos na matriz de comprimento variável, um chamador pode primeiro usar o buffer Atributos para retornar o valor do membro NumGlobalUnknowns das informações de atributos estendidos.

Para obter mais informações, consulte Coleções HID.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Windows 2000 e versões posteriores do Windows.
Plataforma de Destino	Universal
Cabeçalho	hidpi.h (inclua Hidpi.h)
Biblioteca	Hidparse.lib
IRQL	<= DISPATCH_ LEVEL

Confira também

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA