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

Статья
02/07/2025

Подпрограмма HidP_SetUsageValue задает значение элемента управления HID в указанном отчете HID.

Синтаксис

NTSTATUS HidP_SetUsageValue(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in]      USAGE                Usage,
  [in]      ULONG                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_SetUsageValue возвращает одно из следующих значений состояния:

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

Замечания

HidP_SetUsageValue подпрограмма не подписывает значение. Приложение в пользовательском режиме или драйвер в режиме ядра должен подписать значение, в позиции, указанной в структуре HIDP_VALUE_CAPS для этого значения, или вызвать HidP_SetScaledUsageValue.

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

Требования

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

См. также

HIDP_VALUE_CAPS

HidP_SetScaledUsageValue

_HIDP_PREPARSED_DATA

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