funzione HidP_SetScaledUsageValue (hidpi.h)

Articolo
08/07/2023

La routine HidP_SetScaledUsageValue converte un numero fisico firmato e ridimensionato in un valore logico di utilizzo HID e imposta il valore di utilizzo in un report HID specificato.

Sintassi

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

Parametri

[in] ReportType

Specifica un valore 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 numero fisico firmato e ridimensionato, che la routine converte nel valore logico dell'utilizzo.

[in] PreparsedData

Puntatore ai dati pronti di primo livello.

[in, out] Report

Puntatore a un report HID.

[in] ReportLength

Specifica le dimensioni, in byte, del report HID che si trova 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_SetScaledUsageValue restituisce uno dei valori di stato seguenti:

Codice restituito	Descrizione
HIDP_STATUS_SUCCESS	La routine imposta correttamente il valore di utilizzo.
HIDP_STATUS_BAD_LOG_PHY_VALUES	L'utilizzo ha un intervallo logico o fisico non valido che impedisce il ridimensionamento.
HIDP_STATUS_VALUE_OUT_OF_RANGE	Il valore fisico specificato non è compreso nell'intervallo e l'utilizzo non ha valore Null.
HIDP_STATUS_INVALID_REPORT_LENGTH	La lunghezza del report non è valida.
HIDP_STATUS_INVALID_REPORT_TYPE	Il tipo di report specificato non è valido.
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 pronti non sono validi.
HIDP_STATUS_USAGE_NOT_FOUND	L'utilizzo non esiste in alcun report del tipo di report specificato.
HIDP_STATUS_NULL	Il valore fisico specificato non è compreso nell'intervallo, l'utilizzo ha un valore Null e la routine imposta il valore Null.

Commenti

HidP_SetScaledUsageValue imposta il bit del segno.

Se la routine restituisce HIDP_STATUS_INCOMPATIBLE_REPORT_ID, il report specificato contiene l'utilizzo. Tuttavia, un'applicazione in modalità utente o un driver in modalità kernel può impostare l'utilizzo in un report inizializzato zero. Vedere Inizializzazione di report HID.

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