Condividi tramite


funzione HidP_GetButtonCaps (hidpi.h)

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

Sintassi

NTSTATUS HidP_GetButtonCaps(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [out]     PHIDP_BUTTON_CAPS    ButtonCaps,
  [in, out] PUSHORT              ButtonCapsLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData
);

Parametri

[in] ReportType

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

[out] ButtonCaps

Puntatore a un buffer allocato dal chiamante usato dalla routine per restituire 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. In output, questo parametro è impostato sul numero effettivo di elementi restituiti dalla routine.

[in] PreparsedData

Puntatore ai dati preparati di un insieme di livello superiore.

Valore restituito

HidP_GetButtonCaps 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

HidP_GetButtonCaps restituisce la funzionalità di tutti i pulsanti in una raccolta di livello superiore per un tipo di report specificato.

ButtonCapsLength deve essere impostato sul valore del membro NumberXxxButtonCaps della struttura HIDP_CAPS restituita da HidP_GetCaps, dove Xxx specifica il tipo di report.

Per ottenere un subset di funzionalità del pulsante, selezionate dall'utilizzo, dalla pagina di utilizzo o dalla raccolta di collegamenti, usare HidP_GetSpecificButtonCaps.

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 PASSIVE_LEVEL

Vedi anche

HIDP_BUTTON_CAPS

HidP_GetCaps

HidP_GetSpecificButtonCaps

_HIDP_PREPARSED_DATA