funzione HidP_GetValueCaps (hidpi.h)

Articolo
02/07/2025

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

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 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à di valore per il tipo di report specificato.

[in, out] ValueCapsLength

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

[in] PreparsedData

Puntatore a una raccolta di livello superiore prepara i dati.

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 pronti non sono validi.

Osservazioni

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

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

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

Condividi tramite