funzione HidP_GetExtendedAttributes (hidpi.h)

Articolo
02/26/2024

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 dei dati del controllo HID.

[in] PreparsedData

Specifica i dati pronti per la raccolta di livello superiore 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 Attributes (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 tutte le informazioni sull'attributo esteso del controllo.
HIDP_STATUS_BUFFER_TOO_SMALL	Il buffer di attributi non era sufficientemente grande da contenere tutte le informazioni sull'attributo esteso.
HIDP_STATUS_DATA_INDEX_NOT_FOUND	L'indice dati specificato non è valido.

Commenti

HidP_GetExtendedAttributes restituisce una struttura a lunghezza variabile HIDP_EXTENDED_ATTRIBUTES nel buffer Attribute . La struttura degli attributi estesi contiene, in ordine consecutivo, i membri a lunghezza fissa (NumGlobalUnknowns, Reserved e 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 di attributi 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 Attributes per restituire il valore del membro NumGlobalUnknowns delle informazioni sugli attributi estesi.

Per altre informazioni, vedere Raccolte HID.

Requisiti

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

Vedi anche

HIDP_EXTENDED_ATTRIBUTES

HIDP_UNKNOWN_TOKEN

_HIDP_PREPARSED_DATA

Condividi tramite