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 |
|---|---|
|
A rotina retornou com êxito todas as informações de atributo estendido do controle. |
|
O buffer atributo não era grande o suficiente para conter todas as informações de atributo estendido. |
|
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 |