HidP_SetUsages 함수(hidpi.h)

아티클
02/07/2025

HidP_SetUsages 루틴은 HID 보고서에서 지정된 HID 컨트롤 단추 ON(1)을 설정합니다.

통사론

NTSTATUS HidP_SetUsages(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in]      USAGE                UsagePage,
  [in]      USHORT               LinkCollection,
  [in, out] PUSAGE               UsageList,
  [in, out] PULONG               UsageLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData,
  [in]      PCHAR                Report,
  [in]      ULONG                ReportLength
);

매개 변수

[in] ReportType

Report있는 보고서의 형식을 나타내는 HIDP_REPORT_TYPE 열거자 값을 지정합니다.

[in] UsagePage

UsageList지정한 사용량에 대한 사용량 페이지 지정합니다.

[in] LinkCollection

사용량이 포함된 링크 컬렉션 지정합니다. LinkCollection 0이 아닌 경우 루틴은 이 링크 컬렉션에 있는 경우에만 사용량을 설정합니다. LinkCollection 0이면 루틴은 PreparsedData연결된 최상위 컬렉션 지정된 각 사용량에 대한 첫 번째 사용을 설정합니다.

[in, out] UsageList

사용 배열에 대한 포인터입니다.

[in, out] UsageLength

입력에서 UsageList의 사용 횟수를지정합니다. 출력 값에 대한 자세한 내용은 설명 섹션을 참조하세요.

[in] PreparsedData

Report있는 보고서와 연결된 최상위 컬렉션의 준비 데이터 대한 포인터입니다.

[in] Report

보고서에 대한 포인터입니다.

[in] ReportLength

Report있는 보고서의 크기(바이트)를 지정합니다. 이 크기는 컬렉션의 HIDP_CAPS 구조에서 반환되는 지정된 보고서 형식의 보고서 길이와 같아야 HidP_GetCaps.

반환 값

HidP_SetUsages 다음 상태 값 중 하나를 반환합니다.

반환 코드	묘사
HIDP_STATUS_SUCCESS	루틴이 사용 값을 성공적으로 설정합니다.
HIDP_STATUS_BUFFER_TOO_SMALL	배열이 이미 완전히 설정되어 있으므로 단추 배열의 사용량을 설정할 수 없습니다.
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_SetUsagesUsageList사용량을 설정할 수 없는 경우 루틴은 UsageLength 설정할 수 없는 사용량의 인덱스로 설정하고 오류를 나타내는 상태 값을 반환합니다.

자세한 내용은 HID 컬렉션참조하세요.

요구 사항

요구	값
지원되는 최소 클라이언트	Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	보편적
헤더	hidpi.h(Hidpi.h 포함)
라이브러리	Hidparse.lib
IRQL	<= DISPATCH_LEVEL