HidP_GetSpecificValueCaps 함수(hidpi.h)
HidP_GetSpecificValueCaps 루틴은 지정된 선택 조건을 충족하는 모든 HID 컨트롤 값을 설명하는 값 기능 배열을 반환합니다.
구문
NTSTATUS HidP_GetSpecificValueCaps(
[in] HIDP_REPORT_TYPE ReportType,
[in] USAGE UsagePage,
[in] USHORT LinkCollection,
[in] USAGE Usage,
[out] PHIDP_VALUE_CAPS ValueCaps,
[in, out] PUSHORT ValueCapsLength,
[in] PHIDP_PREPARSED_DATA PreparsedData
);
매개 변수
[in] ReportType
보고서 형식을 식별하는 HIDP_REPORT_TYPE 열거자 값을 지정합니다.
[in] UsagePage
사용 페이지를 검색 조건으로 지정합니다. UsagePage가 0이 아닌 경우 이 사용 페이지를 지정하는 값만 반환됩니다.
[in] LinkCollection
링크 컬렉션을 검색 조건으로 지정합니다. LinkCollection이 0이 아닌 경우 이 링크 컬렉션의 일부인 값만 반환됩니다.
[in] Usage
HID 사용을 검색 조건으로 지정합니다. Usage가 0이 아닌 경우 이 사용량을 지정하는 값만 반환됩니다.
[out] ValueCaps
루틴이 지정된 보고서 형식에 대한 값 기능 배열을 반환하는 호출자가 할당한 버퍼에 대한 포인터입니다.
[in, out] ValueCapsLength
ValueCaps에 제공된 버퍼의 입력 길이(배열 요소)를 지정합니다. 출력에서 이 매개 변수는 루틴이 실제로 반환하는 요소 수로 설정됩니다.
[in] PreparsedData
최상위 컬렉션의준비 데이터에 대한 포인터입니다.
반환 값
HidP_GetSpecificValueCaps 다음 상태 값 중 하나를 반환합니다.
| 반환 코드 | NT 상태 값 | Description |
|---|---|---|
|
|
루틴이 기능 데이터를 성공적으로 반환했습니다. |
|
|
준비한 데이터가 잘못되었습니다. |
|
|
지정된 보고서 유형의 보고서에는 사용량이 없습니다. |
설명
ValueCaps 버퍼의 필수 크기는 최상위 컬렉션의 HIDP_CAPS 구조체의 NumberXxxValueCaps 멤버에 의해 지정됩니다.
HidP_GetSpecificValueCaps 호출할 때 UsagePage, Usage 및 LinkCollection에 대해 0을 지정하는 것은 HidP_GetValueCaps 호출하는 것과 같습니다.
컬렉션의 기능에 대한 자세한 내용은 컬렉션 정보 가져오기를 참조하세요.
HID 컬렉션도 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | hidpi.h(Hidpi.h 포함) |
| 라이브러리 | Hidparse.lib |
| IRQL | PASSIVE_LEVEL |