Condividi tramite

funzione HidP_GetScaledUsageValue (hidpi.h)

  • Articolo

La routine HidP_GetScaledUsageValue restituisce il risultato con segno e ridimensionato di un valore di controllo HID estratto da un report HID.

Sintassi

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

Parametri

[in] ReportType

Specifica un valore enumeratore HIDP_REPORT_TYPE che identifica il tipo di report HID che contiene il valore utilizzo HID .

[in] UsagePage

Specifica la pagina di utilizzo del valore da estrarre.

[in] LinkCollection

Specifica l'identificatore della raccolta di collegamenti del valore da estrarre. Un valore LinkCollection pari a zero identifica la raccolta di primo livello.

[in] Usage

Specifica l'utilizzo del valore da estrarre.

[out] UsageValue

Puntatore al buffer in cui la routine restituisce il valore con segno e ridimensionato.

[in] PreparsedData

Puntatore al prepara i dati della raccolta di di primo livello che ha generato il report in Report.

[in] Report

Puntatore al report che contiene l'utilizzo.

[in] ReportLength

Specifica la lunghezza, in byte, del report che si trova in Report.

Valore restituito

HidP_GetScaledUsageValue restituisce uno dei valori di stato seguenti:

Codice restituito Descrizione
HIDP_STATUS_SUCCESS La routine ha restituito correttamente il valore.
HIDP_STATUS_INVALID_REPORT_TYPE Il tipo di report specificato non è valido.
HIDP_STATUS_INVALID_REPORT_LENGTH La lunghezza del report specificata non è valida.
HIDP_STATUS_BAD_LOG_PHY_VALUES La raccolta ha restituito un valore logico o fisico non valido. Per estrarre il valore restituito dalla raccolta, chiamare HidP_GetUsageValue.
HIDP_STATUS_NULL Lo stato corrente del valore ridimensionato dalla raccolta è minore del minimo logico o è maggiore del massimo logico e il valore ridimensionato ha uno stato NULL.
HIDP_STATUS_VALUE_OUT_OF_RANGE Lo stato corrente dei dati del valore ridimensionato dalla raccolta è minore del minimo logico o è maggiore del massimo logico.
HIDP_STATUS_USAGE_NOT_FOUND Impossibile trovare l'utilizzo, la pagina di utilizzo o la raccolta di collegamenti specificata in qualsiasi report supportato dalla raccolta di livello superiore specificata.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID Il valore specificato non è contenuto nel report specificato, ma è contenuto in un altro report supportato dalla raccolta di livello superiore specificata.

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.

I buffer allocati dal chiamante forniti in PreparsedData, UsageValuee Report devono essere allocati da pool non di paging.

Le applicazioni in modalità utente e i driver in modalità kernel devono usare HidP_GetUsageValueArray per estrarre i dati per una matrice di valori di utilizzo .

Se la routine restituisce lo stato HIDP_STATUS_BAD_LOG_PHY_VALUES, un'applicazione o un driver può chiamare HidP_GetUsageValue per estrarre i dati di utilizzo non elaborati.

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