funzione HidP_SetUsageValue (hidpi.h)

Articolo
08/07/2023

La routine HidP_SetUsageValue imposta un valore di controllo HID in un report HID specificato.

Sintassi

NTSTATUS HidP_SetUsageValue(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [in]      ULONG                UsageValue,
  [in]      PHIDP_PREPARSED_DATA PreparsedData,
  [in, out] PCHAR                Report,
  [in]      ULONG                ReportLength
);

Parametri

[in] ReportType

Specifica un valore di enumeratore HIDP_REPORT_TYPE che indica il tipo di report HID disponibile in Report.

[in] UsagePage

Specifica la pagina di utilizzo di un utilizzo.

[in] LinkCollection

Specifica la raccolta di collegamenti che contiene l'utilizzo. Se LinkCollection è diverso da zero, la routine imposta solo l'utilizzo, se presente, in questa raccolta di collegamenti. Se LinkCollection è zero, la routine imposta il primo utilizzo trovato nella raccolta di livello superiore associata a PreparsedData.

[in] Usage

Specifica l'utilizzo.

[in] UsageValue

Specifica il valore di utilizzo.

[in] PreparsedData

Puntatore ai dati preparati di primo livello.

[in, out] Report

Puntatore a un report HID.

[in] ReportLength

Specifica le dimensioni, in byte, del report HID situato in Report, che deve essere uguale alla lunghezza del report per il tipo di report specificato che HidP_GetCaps restituisce nella struttura HIDP_CAPS di una raccolta.

Valore restituito

HidP_SetUsageValue restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
HIDP_STATUS_SUCCESS	La routine imposta correttamente il valore di utilizzo.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID	L'utilizzo non esiste nel report specificato, ma esiste in un report diverso del tipo specificato.
HIDP_STATUS_INVALID_PREPARSED_DATA	I dati preparati non sono validi.
HIDP_STATUS_REPORT_DOES_NOT_EXIST	Non sono presenti report del tipo specificato.
HIDP_STATUS_USAGE_NOT_FOUND	L'utilizzo non esiste in alcun report del tipo di report specificato.
HIDP_STATUS_INVALID_REPORT_LENGTH	La lunghezza del report non è valida.
HIDP_STATUS_INVALID_REPORT_TYPE	Il tipo di report specificato non è valido.

Commenti

HidP_SetUsageValue routine non firma il valore. Un'applicazione in modalità utente o un driver in modalità kernel deve firmare il valore, nella posizione specificata nella struttura HIDP_VALUE_CAPS per questo valore o chiamare HidP_SetScaledUsageValue.

Per altre informazioni, vedere 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_VALUE_CAPS

HidP_SetScaledUsageValue

_HIDP_PREPARSED_DATA

Condividi tramite