função HidP_GetExtendedAttributes (hidpi.h)

Artigo
02/07/2025

A rotina de 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 de enumerador HIDP_REPORT_TYPE 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 o de dados pré-preparados para a coleção de de nível superior que contém o controle especificado.

[out] Attributes

Ponteiro para um buffer alocado por 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).

Valor de retorno

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 de do 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.

Observações

HidP_GetExtendedAttributes retorna uma estrutura de HIDP_EXTENDED_ATTRIBUTES de comprimento variável no buffer de de Atributo. A estrutura de atributos estendidos contém, em ordem consecutiva, os membros de comprimento fixo (NumGlobalUnknowns, Reservados 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*)&(de Atributos–>Data).

A rotina retorna tantos bytes das informações de atributo estendido quanto o buffer de de atributo de 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 NumGlobalUnknowns membro das informações de atributo estendido.

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

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows 2000 e versões posteriores do Windows.
da Plataforma de Destino	Universal
cabeçalho	hidpi.h (inclua Hidpi.h)
biblioteca	Hidparse.lib
IRQL	<= NÍVEL de DISPATCH_

Consulte também

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA

Compartilhar via