HidD_GetPhysicalDescriptor 함수(hidsdi.h)

아티클
08/07/2023

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