Condividi tramite


funzione HidP_GetSpecificButtonCaps (hidpi.h)

La routine HidP_GetSpecificButtonCaps restituisce una matrice di funzionalità del pulsante che descrive tutti i pulsanti di controllo HID in una raccolta di livello superiore che soddisfa i criteri di selezione specificati.

Sintassi

NTSTATUS HidP_GetSpecificButtonCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [out]     PHIDP_BUTTON_CAPS    ButtonCaps,
  [in, out] PUSHORT              ButtonCapsLength,
  [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 pulsanti che specificano questa pagina di utilizzo.

[in] LinkCollection

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

[in] Usage

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

[out] ButtonCaps

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

[in, out] ButtonCapsLength

Specifica la lunghezza dell'input, negli elementi della matrice, del buffer fornito in ButtonCaps. Nell'output, questo parametro viene impostato sul numero di elementi effettivamente restituiti dalla routine.

[in] PreparsedData

Puntatore ai dati prontidi una raccolta di primo livello.

Valore restituito

HidP_GetSpecificButtonCaps 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.

Commenti

Le dimensioni richieste della matrice ButtonCaps sono specificate dai membri NumberXxxButtonCaps della struttura HIDP_CAPS di una raccolta di livello superiore.

Quando si chiama HidP_GetSpecificButtonCaps, specificando zero per UsagePage, Usage e LinkCollection equivale a chiamare HidP_GetButtonCaps.

Per altre informazioni sulle 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 PASSIVE_LEVEL

Vedi anche

HIDP_BUTTON_CAPS

HidP_GetButtonCaps

HidP_GetCaps

_HIDP_PREPARSED_DATA