funzione HidP_GetValueCaps (hidpi.h)

Articolo
02/27/2024

La routine HidP_GetValueCaps restituisce una matrice di funzionalità del valore che descrive tutti i valori di controllo HID in una raccolta di livello superiore per un tipo specificato di report HID.

Sintassi

NTSTATUS HidP_GetValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [out]     PHIDP_VALUE_CAPS     ValueCaps,
  [in, out] PUSHORT              ValueCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

Parametri

[in] ReportType

Specifica un valore dell'enumeratore HIDP_REPORT_TYPE che identifica il tipo di report.

[out] ValueCaps

Puntatore a un buffer allocato dal chiamante in cui la routine restituisce una matrice di funzionalità valore per il tipo di report specificato.

[in, out] ValueCapsLength

Specifica la lunghezza, in input, negli elementi della matrice, del buffer ValueCaps . Nell'output, la routine imposta ValueCapsLength sul numero di elementi effettivamente restituiti.

[in] PreparsedData

Puntatore ai dati preparati di un insieme di livello superiore.

Valore restituito

HidP_GetValueCaps restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
HIDP_STATUS_SUCCESS	La routine ha restituito correttamente i dati delle funzionalità.
HIDP_STATUS_INVALID_PREPARSED_DATA	I dati preparati non sono validi.

Commenti

La lunghezza corretta per ValueCapsLength viene specificata dai membri NumberXxxValueCaps della struttura HIDP_CAPS di un insieme di livello superiore.

Per altre informazioni sulla funzionalità di una raccolta, vedere Ottenere informazioni sulla raccolta.

Vedere anche 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