Condividi tramite

funzione HidP_SetScaledUsageValue (hidpi.h)

  • Articolo

La routine HidP_SetScaledUsageValue converte un numero fisico con segno e ridimensionato in un valore logico 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 che si trova in Report.

[in] UsagePage

Specifica la pagina di utilizzo di un utilizzo.

[in] LinkCollection

Specifica l'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 primo livello associata a PreparsedData.

[in] Usage

Specifica l'utilizzo.

[in] UsageValue

Specifica il numero fisico con segno e ridimensionato, che la routine converte nel valore logico dell'utilizzo.

[in] PreparsedData

Puntatore a un prepara i dati.

[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 un insieme.

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.

Osservazioni

I valori ridimensionati fanno riferimento all'output regolato dei dati HID non elaborati, che vengono modificati in base a parametri specifici, ad esempio la sensibilità e l'intervallo del dispositivo. Questa regolazione consente un'interpretazione più significativa dei dati in relazione all'uso previsto del dispositivo.

Per una maggiore comprensione del modo in cui i report HID vengono interpretati e il significato dei valori ridimensionati, vedere Interpretare i report HID.

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 con inizializzazione zero. Vedere inizializzazione dei report HID.

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

Vedere anche