HidP_InitializeReportForID 함수(hidpi.h)

  • 아티클

HidP_InitializeReportForID 루틴은 HID 보고서를 초기화합니다.

구문

NTSTATUS HidP_InitializeReportForID(
  [in]  HIDP_REPORT_TYPE     ReportType,
  [in]  UCHAR                ReportID,
  [in]  PHIDP_PREPARSED_DATA PreparsedData,
  [out] PCHAR                Report,
  [in]  ULONG                ReportLength
);

매개 변수

[in] ReportType

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

[in] ReportID

보고서 ID를 지정합니다.

[in] PreparsedData

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

[out] Report

HidP_InitializeReportForID 초기화하는 HID 보고서를 포함하는 호출자가 할당한 버퍼에 대한 포인터입니다.

[in] ReportLength

보고서에 있는 HID 보고서의 크기(바이트)를 지정합니다. ReportLength는 컬렉션의 HIDP_CAPS 구조체의 XxxReportByteLength 멤버에 지정된 대로 지정된 보고서 형식에 대한 컬렉션의 보고서 길이와 같아야 합니다.

반환 값

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

반환 코드 설명
HIDP_STATUS_SUCCESS
 보고서가 성공적으로 초기화되었습니다.
HIDP_STATUS_INVALID_PREPARSED_DATA
 준비한 데이터가 잘못되었습니다.
HIDP_STATUS_INVALID_REPORT_LENGTH
 보고서의 지정된 길이가 지정된 보고서 형식에 대한 컬렉션의 보고서 길이와 같지 않습니다.
HIDP_STATUS_INVALID_REPORT_TYPE
 보고서 유형이 잘못되었습니다.
HIDP_STATUS_REPORT_DOES_NOT_EXIST
 지정한 보고서 ID가 잘못되었습니다.

설명

HID 보고서를 초기화하면 USB HID 표준에 정의된 대로 모든 컨트롤 데이터가 0 또는 컨트롤의 null 값으로 설정됩니다. (null 값을 보내거나 받는 것은 컨트롤의 현재 값을 수정해서는 안 됨을 나타냅니다.)

HidP_InitializeReportForID 다음을 수행합니다.

  • null 값이 없는 모든 단추 및 값의 비트 필드를 0으로 설정합니다.
  • null 값이 있는 모든 컨트롤의 비트 필드를 해당 null 값으로 설정합니다.
자세한 내용은 HID 컬렉션을 참조하세요.

요구 사항

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

추가 정보

HIDP_CAPS

HIDP_REPORT_TYPE

HidP_GetCaps

_HIDP_PREPARSED_DATA