HidD_GetPhysicalDescriptor 함수(hidsdi.h)
HidD_GetPhysicalDescriptor 루틴은 컬렉션의 물리적 디바이스를 식별하는 최상위 컬렉션의 물리적 설명자를 반환합니다.
물리적 설명자는 디바이스에서 컨트롤을 활성화하는 데 사용되는 인체의 물리적 부분을 나타내는 데 사용됩니다. 예를 들어 물리적 설명자는 오른쪽 엄지 손가락이 단추 5를 활성화하는 데 사용됨을 나타낼 수 있습니다.
물리적 설명자는 전적으로 선택 사항입니다. 복잡성을 더하고 대부분의 디바이스에 대한 대가로 거의 제공하지 않습니다. 그러나 일부 디바이스, 특히 동일한 컨트롤(예: 단추)이 많은 디바이스는 물리적 설명자가 다른 애플리케이션이 보다 일관된 방식으로 이러한 컨트롤에 기능을 할당하는 데 도움이 됨을 알 수 있습니다. 자세한 내용은 HID 사양 을 참조하세요.
구문
BOOLEAN HidD_GetPhysicalDescriptor(
[in] HANDLE HidDeviceObject,
[out] PVOID Buffer,
[in] ULONG BufferLength
);
매개 변수
[in] HidDeviceObject
최상위 컬렉션에 대한 열린 핸들을 지정합니다.
[out] Buffer
루틴이 요청된 물리적 설명자를 반환하는 데 사용하는 호출자 할당 버퍼에 대한 포인터입니다.
[in] BufferLength
버퍼의 버퍼 길이(바이트)를 지정합니다.
반환 값
HidD_GetPhysicalDescriptor 성공하면 TRUE 를 반환합니다. 그렇지 않으면 FALSE를 반환 합니다. GetLastError를 사용하여 확장된 오류 정보를 가져옵니다.
설명
사용자 모드 애플리케이션만 HidD_GetPhysicalDescriptor 호출할 수 있습니다. 커널 모드 드라이버는 IOCTL_GET_PHYSICAL_DESCRIPTOR 요청을 사용할 수 있습니다.
자세한 내용은 HID 컬렉션을 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows 2000 이상 버전의 Windows에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | hidsdi.h(Hidsdi.h 포함) |
| 라이브러리 | Hid.lib |
| DLL | Hid.dll |