Condividi tramite


funzione HidP_GetValueCaps (hidpi.h)

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

Vedi anche

HIDP_CAPS

HIDP_VALUE_CAPS

HidP_GetButtonCaps

HidP_GetCaps

_HIDP_PREPARSED_DATA