Поделиться через

функция HidP_SetScaledUsageValue (hidpi.h)

  • Статья

Подпрограмма HidP_SetScaledUsageValue преобразует подписанный и масштабированный физический номер в логического значения использования HID и задает значение использования в указанном отчете HID.

Синтаксис

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
);

Параметры

[in] ReportType

Указывает значение перечислителя HIDP_REPORT_TYPE, указывающее тип отчета HID, расположенного в отчете.

[in] UsagePage

Указывает страницу использования использования.

[in] LinkCollection

Указывает коллекцию ссылок , содержащую использование. Если LinkCollection ненулевое, подпрограмма задает только использование, если таковой существует, в этой коллекции ссылок. Если LinkCollection равно нулю, подпрограмма устанавливает первое использование, найденное в коллекции верхнего уровня, связанной с PreparsedData.

[in] Usage

Указывает использование.

[in] UsageValue

Указывает подписанный и масштабируемый физический номер, который подпрограмма преобразует в логическое значение использования.

[in] PreparsedData

Указатель на предварительно подготовленныхданных верхнего уровня.

[in, out] Report

Указатель на отчет HID.

[in] ReportLength

Указывает размер отчета HID в байтах, расположенный в отчета, который должен быть равен длине отчета для указанного типа отчета, который HidP_GetCaps возвращается в HIDP_CAPS структуре коллекции.

Возвращаемое значение

HidP_SetScaledUsageValue возвращает одно из следующих значений состояния:

Возвращаемый код Описание
HIDP_STATUS_SUCCESS Подпрограмма успешно задает значение использования.
HIDP_STATUS_BAD_LOG_PHY_VALUES Использование имеет недопустимый логический или физический диапазон, который предотвращает масштабирование.
HIDP_STATUS_VALUE_OUT_OF_RANGE Указанное физическое значение выходит за пределы диапазона, а использование не имеет значения NULL.
HIDP_STATUS_INVALID_REPORT_LENGTH Длина отчета недопустима.
HIDP_STATUS_INVALID_REPORT_TYPE Указанный тип отчета недопустим.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID Использование не существует в указанном отчете, но оно существует в другом отчете указанного типа.
HIDP_STATUS_INVALID_PREPARSED_DATA Предварительно подготовленные данные недопустимы.
HIDP_STATUS_USAGE_NOT_FOUND Использование не существует в любом отчете указанного типа отчета.
HIDP_STATUS_NULL Указанное физическое значение выходит за пределы диапазона, использование имеет значение NULL, а подпрограмма задает значение NULL.

Замечания

Масштабируемые значения относятся к скорректированному выводу необработанных данных HID, которые изменяются на основе определенных параметров, таких как конфиденциальность и диапазон устройства. Эта корректировка позволяет более понятно интерпретировать данные относительно предполагаемого использования устройства.

Дополнительные сведения о интерпретации отчетов HID и важности масштабируемых значений см. в интерпретации отчетов HID.

HidP_SetScaledUsageValue задает бит знака.

Если подпрограмма возвращает HIDP_STATUS_INCOMPATIBLE_REPORT_ID, указанный отчет содержит использование. Однако драйвер пользовательского режима или приложения в режиме ядра может задать использование в ноль-инициализированном отчете. См. инициализации отчетов HID.

Дополнительные сведения см. в коллекциях HID.

Требования

Требование Ценность
минимальные поддерживаемые клиентские Доступно в Windows 2000 и более поздних версиях Windows.
целевая платформа Всеобщий
заголовка hidpi.h (include Hidpi.h)
библиотеки Hidparse.lib
IRQL <= DISPATCH_LEVEL

См. также