HID용 디바이스 기능을 지정하는 방법

참고 Windows 10 Windows 10 다른 내용을 참조하세요.

 

패키지 매니페스트는 시스템에서 Windows 런타임 앱을 배포, 표시 또는 업데이트하는 데 필요한 정보를 포함하는 XML 문서입니다. 이 정보에는 패키지 ID, 패키지 종속성, 필요한 기능, 시각적 요소 및 확장성 지점이 포함됩니다. 모든 앱 패키지에는 하나의 패키지 매니페스트가 포함되어야 합니다.

HID 디바이스에 액세스하는 Windows 런타임 앱은 매니페스트의 기능 노드에 특정 DeviceCapability 데이터를 포함해야 합니다. 이 데이터는 디바이스 및 해당 용도(또는 함수)를 식별합니다. 일부 디바이스에는 여러 함수가 있을 수 있습니다.

디바이스 ID 요소는 디바이스 식별자에 해당합니다. 이 요소는 vid( 공급업체 ID ) 및 제품 ID(pid) 조합을 지정할 수 있습니다. 또는 제네릭 문자열("any")을 지정할 수 있습니다. 또한 디바이스 ID 에는 "usb" 또는 "bluetooth"의 선택적 공급자 문자열이 포함될 수 있습니다.

Function Type 요소는 디바이스 함수를 지정합니다. 이 요소에는 하나 이상의 HID 사용 값이 포함됩니다. 이러한 값은 사용량 페이지 와 선택적 사용 ID로 구성되며, 각각은 16비트 16비트 16진수 값입니다.

DeviceCapabilities 예제

이 섹션에는 세 개의 HID 디바이스에 대한 예제 DeviceCapabilities 항목이 포함되어 있습니다. 처음 두 가지는 HID 디바이스에서 공급업체에서 정의한 사용량, 세 번째는 게임 장치(게임 컨트롤 페이지) 및 조이스틱 및 게임 패드의 네 번째 사용량에 해당합니다.

다음 공급업체 정의 사용량 현황 데이터에서 디바이스는 공급업체 ID 및 제품 ID 조합으로 식별됩니다.

<!-- HID Device -->
<DeviceCapability Name="humaninterfacedevice">
    <Device Id="vidpid:0A81 0701">
      <Function Type="usage:ffa0 0001"/>
    </Device>
</DeviceCapability>

다음은 Device Id 요소의 추가 공급자 문자열("usb")을 제외하고 첫 번째와 동일합니다.

<!-- HID Device -->
<DeviceCapability Name="humaninterfacedevice">
    <Device Id="vidpid:0A81 0701 usb">
      <Function Type="usage:ffa0 0001"/>
    </Device>
</DeviceCapability>

다음 게임 디바이스 데이터에는 공급업체 ID 및 제품 ID가 없습니다.

<!-- Any gamepad device  -->
<DeviceCapability Name="humaninterfacedevice">
    <Device Id="any">
      <Function Type="usage:0005 *"/>
    </Device>
</DeviceCapability>

다음 조이스틱 및 게임 패드 데이터에는 공급업체 ID 및 제품 ID가 없습니다.

<!-- Any generic gaming device  -->
<DeviceCapability Name="humaninterfacedevice">
    <Device Id="any">
      <Function Type="usage:0004 *"/>
      <Function Type="usage:0005 *"/>
    </Device>
</DeviceCapability>

Windows 8.x 전화 앱에 대한 요구 사항

Windows 8.x 전화 앱은 Windows 액세스할 수 있습니다. 제조업체가 특정 디바이스에 대해 HID 프로토콜을 지원하고 앱 개발자에게 해당 디바이스 데이터를 제공한 경우 Devices.HumanInterfaceDevice API입니다. 지원되는 HID 디바이스 목록과 디바이스 검색을 구현하는 데 필요한 데이터는 제조업체의 설명서를 참조하세요.

관련 항목

Windows.Devices.HumanInterfaceDevice