Catatan
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba masuk atau mengubah direktori.
Akses ke halaman ini memerlukan otorisasi. Anda dapat mencoba mengubah direktori.
Important
Metadata perangkat tidak digunakan lagi dan akan dihapus dalam rilis Windows mendatang. Untuk informasi tentang penggantian fungsionalitas ini, lihat Metadata Kontainer Paket Driver.
Topik ini memperkenalkan cara aplikasi perangkat UWP dapat mengakses perangkat internal. Internal devices are devices that reside inside or are integrated with the PC enclosure.
Beberapa API yang disebutkan dalam topik ini juga dapat digunakan untuk mengakses perangkat eksternal. Topik ini berfokus khusus pada mengakses perangkat internal. Untuk informasi selengkapnya tentang setiap API, lihat referensi Windows API.
Mengakses perangkat internal
Ada tiga cara agar aplikasi UWP dapat mengakses perangkat internal:
| Recommended? | API | Pengembang | Apakah metadata perangkat diperlukan? |
|---|---|---|---|
| Yes | API skenario perangkat (pengambilan gambar, pemindaian, dll.) | all developers | no |
| Yes | API protokol perangkat (USB, HID, dll.) | OEM | ya (hanya untuk perangkat internal) |
| No | Akses pengandar kustom | OEM | yes |
API skenario perangkat
Windows Runtime menyediakan beberapa API untuk mengakses perangkat umum yang terpasang atau terpasang ke PC, seperti API untuk pengambilan gambar, pemindaian, pencetakan, dan menggunakan sensor gerakan. Karena API ini dirancang dengan skenario tertentu, API tersebut disebut sebagai API skenario perangkat. API skenario perangkat dapat digunakan oleh semua pengembang dan tidak ada metadata perangkat yang diperlukan untuk menggunakannya. For more info about scenario APIs, see Integrating devices.
Akses apa pun di luar apa yang ditawarkan API skenario perangkat terbatas pada OEM (atau pemasok komponen, bekerja dalam koordinasi dengan OEM), dan memerlukan metadata perangkat untuk kontainer sistem.
API protokol perangkat
Ketika pemasok OEM/komponen perlu mengakses perangkat internal dengan cara yang tidak terpenuhi oleh API skenario, mereka dapat menggunakan API protokol perangkat. API protokol perangkat adalah API Windows Runtime yang dapat digunakan aplikasi UWP untuk mengakses perangkat USB dan perangkat antarmuka manusia (HID). Jenis akses bervariasi per API.
| API protokol perangkat | Namespace | Access type |
|---|---|---|
| USB | Windows.Devices.Usb | pembacaan eksklusif & penulisan eksklusif |
| HID | Windows.Devices.HumanInterfaceDevice | akses baca bersama & akses tulis eksklusif |
Untuk mengakses perangkat periferal yang hanya menggunakan driver kelas Microsoft - penggunaan paling umum untuk API protokol perangkat - metadata perangkat tidak diperlukan. Namun, untuk mengakses perangkat internal dengan API tersebut, metadata diperlukan. Saat mengakses perangkat internal, aplikasi harus ditentukan dalam metadata perangkat sebagai aplikasi istimewa untuk kontainer sistem. Persyaratan ini membatasi akses perangkat internal ke OEM.
Untuk informasi selengkapnya, lihat:
Persyaratan driver perangkat (dari langkah 1 panduan langkah demi langkah)
Membuat metadata perangkat (langkah 2 dari panduan langkah demi langkah)
Akses pengandar kustom
Ketika OEM atau IHV tidak dapat menggunakan API protokol perangkat untuk mengakses perangkat (internal atau periferal) mereka, mereka harus terlebih dahulu menghubungi Microsoft untuk membahas skenario mereka dengan tim Ekosistem Windows. Dalam beberapa kasus - setelah persetujuan Microsoft - aplikasi perangkat UWP dapat langsung mengakses driver kustom.
Akses driver kustom memerlukan metadata perangkat. Untuk mengakses driver kustom, aplikasi harus ditentukan dalam metadata perangkat sebagai aplikasi istimewa untuk perangkat periferal atau kontainer sistem. Untuk informasi selengkapnya tentang akses driver kustom, lihat panduan desain aplikasi perangkat UWP untuk perangkat khusus internal ke PC.
Component suppliers
Pemasok komponen dapat bekerja dengan OEM untuk mengembangkan aplikasi perangkat UWP untuk perangkat internal mereka. Ini dapat terjadi dalam beberapa cara:
Pemasok komponen mengembangkan dan mendistribusikan aplikasi: Dalam hal ini, pemasok komponen memiliki, mengembangkan, dan mendistribusikan aplikasi dan driver yang mengakses perangkat internal. OEM memiliki metadata perangkat.
OEM mengembangkan dan mendistribusikan aplikasi: Dalam hal ini, OEM mengembangkan dan mendistribusikan aplikasi yang mengakses satu atau beberapa perangkat internal dari pemasok komponen yang berbeda. OEM pada akhirnya memiliki pengembangan aplikasi, distribusi aplikasi, dan pemeliharaan metadata perangkat. Pemasok komponen memiliki driver.
Untuk informasi selengkapnya tentang alur kerja ini, lihat panduan desain aplikasi perangkat UWP untuk perangkat khusus internal ke PC.