funzione HidP_GetScaledUsageValue (hidpi.h)

Articolo
08/07/2023

La routine HidP_GetScaledUsageValue restituisce il risultato firmato 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 di enumeratore HIDP_REPORT_TYPE che identifica il tipo di report HID contenente il valore di 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 firmato e ridimensionato.

[in] PreparsedData

Puntatore ai dati preparati della raccolta di primo livello che ha generato il report in Report.

[in] Report

Puntatore al report contenente l'utilizzo.

[in] ReportLength

Specifica la lunghezza, in byte, del report disponibile 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 la raccolta di utilizzo, utilizzo o collegamento specificata in qualsiasi report supportato dalla raccolta di primo livello specificata.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID	Il valore specificato non è contenuto nel report specificato, ma è contenuto in un altro report supportato dalla raccolta di primo livello specificata.

Commenti

I buffer allocati dal chiamante forniti in PreparsedData, UsageValue e Report devono essere allocati dal pool non a pagina.

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.

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_GetUsageValue

HidP_GetUsageValueArray

_HIDP_PREPARSED_DATA

Condividi tramite