HidP_SetData 함수(hidpi.h)

아티클
08/07/2023

HidP_SetData 루틴은 HID 보고서에서 지정된 HID 컨트롤 단추 집합과 값 사용량을 설정합니다.

구문

NTSTATUS HidP_SetData(
  [in]      HIDP_REPORT_TYPE     ReportType,
  [in, out] PHIDP_DATA           DataList,
  [in, out] PULONG               DataLength,
  [in]      PHIDP_PREPARSED_DATA PreparsedData,
  [in]      PCHAR                Report,
  [in]      ULONG                ReportLength
);

매개 변수

[in] ReportType

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

[in, out] DataList

설정할 단추 및 사용량 값을 지정하는 호출자가 할당한 HIDP_DATA 구조체 배열에 대한 포인터입니다.

[in, out] DataLength

입력에서 DataList 배열의 멤버 수를 지정합니다. 출력 값에 대한 자세한 내용은 설명 섹션을 참조하세요.

[in] PreparsedData

최상위의 준비 데이터에 대한 포인터입니다.

[in] Report

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

[in] ReportLength

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

반환 값

HidP_SetDataDataList에서 지정한 모든 컨트롤 데이터를 성공적으로 설정하면 HIDP_STATUS_SUCCESS 반환합니다.

HidP_SetData 입력 매개 변수 중 하나가 유효하지 않으면 다음 상태 값 중 하나를 반환합니다.

반환 코드	설명
HIDP_STATUS_INVALID_PREPARSED_DATA	PreparsedData에서 지정한 준비 데이터가 잘못되었습니다.
HIDP_STATUS_INVALID_REPORT_LENGTH	HID 보고서의 크기(바이트)는 지정된 보고서 형식에 대한 컬렉션의 HIDP_CAPS 구조에 지정된 길이와 같지 않습니다.
HIDP_STATUS_INVALID_REPORT_TYPE	ReportType 이 잘못되었습니다.
HIDP_STATUS_REPORT_DOES_NOT_EXIST	컬렉션에 지정된 형식의 보고서가 포함되어 있지 않습니다.

지정된 단추 또는 사용량 값 중 하나를 설정할 수 없는 경우 HidP_SetData 다음 오류 값 중 하나를 반환합니다.

반환 코드	설명
HIDP_STATUS_BUFFER_TOO_SMALL	모든 배열 필드가 이미 다른 단추를 인덱싱하는 데 사용되었으므로 배열의 단추가 ON(1)으로 설정되지 않았습니다.
HIDP_STATUS_BUTTON_NOT_PRESSED	DataList 멤버는 단추 OFF(0)를 설정하도록 지정하지만 단추는 이미 OFF로 설정되어 있습니다.
HIDP_STATUS_DATA_INDEX_NOT_FOUND	DataList 멤버의 데이터 인덱스가 잘못되었습니다.
HIDP_STATUS_INCOMPATIBLE_REPORT_ID	단추 또는 사용량 값은 보고서에 포함되지만 지정된 보고서에는 없습니다.
HIDP_STATUS_IS_VALUE_ARRAY	데이터 인덱스는 사용량 값 배열을 지정합니다.

설명

사용량 값 배열을 제외하고 사용자 모드 애플리케이션 또는 커널 모드 드라이버는 HidP_SetData 사용하여 보고서에서 단추 및 사용량 값을 설정할 수 있습니다. 사용량 값 배열을 설정하려면 애플리케이션 또는 드라이버에서 HidP_SetUsageValueArray 사용해야 합니다.

HidP_SetData다음과 같이 DataLength 의 출력 값을 설정합니다.

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

요구 사항

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