Windows.Devices.HumanInterfaceDevice Ruang nama

Namespace layanan ini memberi aplikasi UWP Anda akses ke perangkat yang mendukung protokol Human Interface Device (HID ).

Dukungan Perangkat

Namespace ini mendukung sebagian besar HID. Namun, ini tidak menyediakan akses ke koleksi aplikasi tingkat atas (TLC) yang diwakili oleh penggunaan berikut.

Penggunaan tidak dapat diakses.

• Perangkat keyboard dan mouse adalah perangkat yang dipesan sistem
• HID LampArray dapat dijumlahkan dengan HidDevice.GetDeviceSelector tetapi harus dibuat dengan LampArray.FromIdAsync
• HID Sensor dapat dijumlahkan dengan HidDevice.GetDeviceSelector tetapi harus dibuat dengan perangkat Windows.Devices.Sensors masing-masing (misalnya LightSensor.FromIdAsync)

Kemampuan Perangkat Antarmuka Manusia

Aplikasi UWP yang mengakses HID harus menyertakan data kemampuan perangkat tertentu dalam simpul kemampuan manifesnya. Data ini mengidentifikasi perangkat dan tujuannya (atau fungsi). Perhatikan bahwa beberapa perangkat mungkin memiliki beberapa fungsi.

Sejak Windows 10, versi 1809 (Pembaruan Oktober 2018)

• <DeviceCapability>: Atribut Name harus humanInterfaceDevice.

<DeviceCapability Name="humanInterfaceDevice"/>

Jika menargetkan perangkat telepon HID (UsagePage==0x0B), kemampuan hidTelephony tambahan juga harus ditentukan.

<DeviceCapability Name="humanInterfaceDevice"/>
<DeviceCapability Name="hidTelephony"/>

Sebelum Windows 10, versi 1809 (Pembaruan Oktober 2018)

Sejak 1809, ProductId VendorId/ dan jenis fungsi tidak perlu lagi ditentukan dan akan diabaikan pada sistem yang lebih baru. Jika menargetkan sistem sebelum 1809, lihat di bawah ini.

• <DeviceCapability>: Atribut Name harus humanInterfaceDevice.

  • <Perangkat>: Atribut Id harus menentukan pengidentifikasi perangkat. Elemen ini dapat menentukan kombinasi Id Vendor (vid) dan Id Produk (pid); atau, ini dapat menentukan string anygenerik . Selain itu, Device Id mungkin berisi string usb penyedia opsional atau bluetooth.

    • <Fungsi>: Atribut Jenis menentukan fungsi perangkat. Elemen ini berisi satu atau beberapa nilai penggunaan HID. Nilai-nilai ini terdiri UsagePage dari dan opsional UsageId, yang masing-masing adalah nilai heksadesimal 16-bit.

Dalam data penggunaan yang ditentukan vendor berikut, perangkat diidentifikasi oleh kombinasi Id Vendor dan Id Produk .

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

Berikut ini identik dengan yang pertama dengan pengecualian string usb penyedia tambahan dalam Device Id elemen .

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

Dalam data perangkat game berikut tidak ada Id Vendor dan Id Produk.

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

Dalam data joystick dan game pad berikut tidak ada Id Vendor dan Id Produk

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

Pemecahan Masalah

• Verifikasi kemampuan HID (humanInterfaceDevice) ada dalam manifes aplikasi. Jika perangkat telepon, pastikan hidTelephony kemampuan juga disertakan.
• Verifikasi bahwa pengguna telah memberikan izin bagi aplikasi untuk menggunakan HID.
• Verifikasi bahwa jenis perangkat tidak satu pun ditunjuk sebagai tidak dapat diakses.
  • HID yang tidak dapat diakses mungkin masih dijumlahkan oleh DeviceInformation.FindAllAsync(), tetapi tidak dapat dibuka oleh HumanInterfaceDevice.FromIdAsync(). Mengintegrasikan untuk membuka perangkat seperti itu akan melemparkan pengecualian atau mengembalikan null.
• Perangkat internal mesin (DEVPKEY_Device_InLocalMachineContainer == TRUE) umumnya tidak dapat diakses kecuali berjalan pada SKU dengan mode dan lowLevelDevices kemampuan yang disematkan.
• Perangkat dengan tumpukan yang berisi driver filter atas/bawah umumnya tidak dapat diakses. Ini kadang-kadang ditambahkan oleh pihak ke-3 untuk mengaktifkan fungsionalitas tambahan untuk perangkat keras kustom.
  • Pembatasan perangkat ditentukan sebagian oleh hidclass.sys selama enumerasi perangkat, yang dapat mengatur properti DEVPKEY_DeviceInterface_Restricted antarmuka perangkat ke TRUE pada Antarmuka GUID_DEVINTERFACE_HID Perangkat HID berdasarkan keberadaan filter perangkat/kelas.
  • Kehadiran driver UpperFilter/LowerFilter perangkat dapat ditentukan menggunakan DeviceManager dengan mencari UpperFilters properti dan LowerFilters .
  • Kehadiran driver UpperFilter/LowerFilter kelas HID dapat ditentukan menggunakan DeviceManager dengan mencari Class upper filters properti dan Class lower filters .
  • Properti Antarmuka Perangkat dapat diperiksa dengan memanggil CM_Get_Device_Interface_Property di mana pszDeviceInterface string yang sama seperti yang akan diteruskan ke FromIdAsync.
• Pembatasan ini dapat dilewati saat membuat perangkat kustom dengan bekerja sama dengan pengembang driver untuk membuat Aplikasi Dukungan Perangkat Keras