HidP_UnsetUsages 함수(hidpi.h)
HidP_UnsetUsages 루틴은 HID 보고서에서 지정된 HID 컨트롤 단추 사용량 OFF(0)를 설정합니다.
구문
NTSTATUS HidP_UnsetUsages(
[in] HIDP_REPORT_TYPE ReportType,
[in] USAGE UsagePage,
[in, optional] USHORT LinkCollection,
[in, out] PUSAGE UsageList,
[in, out] PULONG UsageLength,
[in] PHIDP_PREPARSED_DATA PreparsedData,
[in] PCHAR Report,
[in] ULONG ReportLength
);
매개 변수
[in] ReportType
보고서에 있는 보고서의 형식을 나타내는 HIDP_REPORT_TYPE 열거자 값을 지정합니다.
[in] UsagePage
UsageList에 지정된 사용량의 사용 페이지를 지정합니다.
[in, optional] LinkCollection
사용량이 포함된 링크 컬렉션을 지정합니다. LinkCollection이 0이 아닌 경우 루틴은 이 링크 컬렉션에 있는 사용량만 설정합니다. LinkCollection이 0인 경우 루틴은 PreparsedData와 연결된 최상위 컬렉션에서 찾은 각 사용량에 대한 첫 번째 사용을 설정합니다.
[in, out] UsageList
OFF로 설정할 사용량 배열에 대한 포인터입니다.
[in, out] UsageLength
입력에서 UsageList의 사용 횟수를 지정합니다. 출력 값에 대한 자세한 내용은 설명 섹션을 참조하세요.
[in] PreparsedData
보고서에 있는 보고서와 연결된 최상위 컬렉션의 준비 데이터에 대한 포인터입니다.
[in] Report
보고서에 대한 포인터입니다.
[in] ReportLength
보고서에 있는 보고서의 크기(바이트)를 지정합니다. 이 크기는 컬렉션의 HIDP_CAPS 구조에서 반환할 HidP_GetCaps 지정한 보고서 형식의 보고서 길이와 같아야 합니다.
반환 값
HidP_UnsetUsagesUsageList의 모든 사용량을 OFF로 성공적으로 설정하면 HIDP_STATUS_SUCCESS 반환합니다.
HidP_UnsetUsages 입력 매개 변수 중 하나가 유효하지 않으면 다음 상태 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
PreparsedData에서 지정한 준비 데이터가 잘못되었습니다. |
|
보고서 길이가 잘못되었습니다. |
|
보고서 유형이 잘못되었습니다. |
|
컬렉션에 지정된 형식의 보고서가 포함되어 있지 않습니다. |
HidP_UnsetUsagesUsageList의 사용 중 하나를 OFF로 설정할 수 없는 경우 다음 상태 값 중 하나를 반환합니다.
| 반환 코드 | 설명 |
|---|---|
|
사용량이 이미 OFF로 설정되어 있습니다. |
|
사용법은 지정된 보고서에 포함되지 않지만 지정된 형식의 다른 보고서에 포함되어 있습니다. |
|
루틴이 지정된 형식의 보고서에서 사용량을 찾지 못했습니다. |
설명
HidP_UnsetUsages다음과 같이 UsageLength 를 설정합니다.
자세한 내용은 HID 컬렉션을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | hidpi.h(Hidpi.h 포함) |
| 라이브러리 | Hidparse.lib |
| IRQL | <=DISPATCH_LEVEL |