funzione HidP_GetSpecificValueCaps (hidpi.h)

Articolo
02/07/2025

La routine HidP_GetSpecificValueCaps restituisce una matrice di funzionalità di valore che descrive tutti i valori di controllo HID che soddisfano i criteri di selezione specificati.

Sintassi

NTSTATUS HidP_GetSpecificValueCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [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.

[in] UsagePage

Specifica una pagina di utilizzo come criteri di ricerca. Se UsagePage è diverso da zero, vengono restituiti solo i valori che specificano questa pagina di utilizzo.

[in] LinkCollection

Specifica un raccolta di collegamenti come criteri di ricerca. Se LinkCollection è diverso da zero, vengono restituiti solo i valori che fanno parte di questa raccolta di collegamenti.

[in] Usage

Specifica un utilizzo hid come criteri di ricerca. Se utilizzo è diverso da zero, verranno restituiti solo i valori che specificano questo utilizzo.

[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 dell'input, negli elementi della matrice, del buffer fornito in ValueCaps. In output, questo parametro viene impostato sul numero di elementi restituiti dalla routine.

[in] PreparsedData

Puntatore a una raccolta di di livello superiore prepara i dati.

Valore restituito

HidP_GetSpecificValueCaps restituisce uno dei valori di stato seguenti:

Codice restituito	Valore di stato NT	Descrizione
HIDP_STATUS_SUCCESS	0x00110000	La routine ha restituito correttamente i dati delle funzionalità.
HIDP_STATUS_INVALID_PREPARSED_DATA	0xc0110001	I dati pronti non sono validi.
HIDP_STATUS_USAGE_NOT_FOUND	0xc0110004	L'utilizzo non esiste in alcun report del tipo di report specificato.

Osservazioni

Le dimensioni necessarie del buffer di ValueCaps sono specificate dal NumberXxxValueCaps membri della struttura HIDP_CAPS di un insieme di livello superiore.

Quando si chiama HidP_GetSpecificValueCaps, specificando zero per UsagePage, Usagee LinkCollection equivale a chiamare HidP_GetValueCaps.

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	PASSIVE_LEVEL

Vedere anche

Condividi tramite