funzione HidP_GetExtendedAttributes (hidpi.h)

Articolo
02/07/2025

La routine HidP_GetExtendedAttributes restituisce gli attributi estesi di un controllo HID.

Sintassi

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
);

Parametri

[in] ReportType

Specifica un valore enumeratore HIDP_REPORT_TYPE che indica il tipo di report HID associato al controllo HID specificato da DataIndex.

[in] DataIndex

Specifica l'indice dati del controllo HID.

[in] PreparsedData

Specifica l'prepara i dati per l' raccolta di primo livello che contiene il controllo specificato.

[out] Attributes

Puntatore a un buffer allocato dal chiamante utilizzato dalla routine per restituire gli attributi estesi del controllo specificato da DataIndex.

[in, out] LengthAttributes

Specifica le dimensioni, in byte, del buffer attributi (che deve essere maggiore o uguale a sizeof(HIDP_EXTENDED_ATTRIBUTES).

Valore restituito

HidP_GetExtendedAttributes restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
HIDP_STATUS_SUCCESS	La routine ha restituito correttamente tutte le informazioni sull'attributo esteso del controllo.
HIDP_STATUS_BUFFER_TOO_SMALL	Il buffer attributo non è sufficiente per contenere tutte le informazioni sull'attributo esteso.
HIDP_STATUS_DATA_INDEX_NOT_FOUND	L'indice dati specificato non è valido.

Osservazioni

HidP_GetExtendedAttributes restituisce una struttura HIDP_EXTENDED_ATTRIBUTES di lunghezza variabile nel buffer attribute. La struttura degli attributi estesi contiene, in ordine consecutivo, i membri a lunghezza fissa (NumGlobalUnknowns, Reservede GlobalUnknowns) seguiti da una matrice di lunghezza variabile di strutture HIDP_UNKNOWN_TOKEN. Il primo membro della matrice di token sconosciuto si trova in (PHIDP_UNKNOWN_TOKEN*)&(Attributes->Data).

La routine restituisce il numero di byte delle informazioni sull'attributo esteso che il buffer attributo può contenere. Se il buffer è troppo piccolo, la routine tronca le informazioni restituite. Per determinare il numero di token sconosciuti nella matrice di lunghezza variabile, un chiamante può prima usare il buffer attributi per restituire il valore di NumGlobalUnknowns membro delle informazioni sugli attributi estesi.

Per altre informazioni, vedere raccolte HID.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows 2000 e versioni successive di Windows.
piattaforma di destinazione	Universale
intestazione	hidpi.h (include Hidpi.h)
libreria	Hidparse.lib
IRQL	<= DISPATCH_ LEVEL

Vedere anche

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA

Condividi tramite