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.
Setiap perangkat memiliki properti DeviceInformation terkait yang dapat Anda gunakan saat memerlukan informasi tertentu atau saat membuat pemilih perangkat. Filter Advanced Query Syntax (AQS) dapat digunakan untuk menentukan properti ini dan membatasi perangkat enumerasi dengan sifat yang ditentukan. Anda juga dapat menggunakan properti ini untuk menunjukkan informasi apa yang ingin Anda kembalikan untuk setiap perangkat. Hal ini memungkinkan Anda menentukan informasi perangkat yang dikembalikan ke aplikasi Anda.
- API penting:Windows.Devices.Enumeration
Untuk informasi selengkapnya tentang menggunakan properti DeviceInformation dalam pemilih perangkat Anda, lihat Membuat pemilih perangkat. Topik ini menunjukkan cara meminta properti informasi dan menjelaskan beberapa properti umum.
Objek DeviceInformation terdiri dari identitas (DeviceInformation.Id), jenis (DeviceInformation.Kind), dan tas properti (DeviceInformation.Properties). Semua properti lain dari objek DeviceInformation berasal dari kumpulan properti Properties. Misalnya, Nama berasal dari System.ItemNameDisplay. Ini berarti bahwa tas properti selalu berisi informasi yang diperlukan untuk menentukan properti lain.
Meminta properti
Objek DeviceInformation memiliki beberapa properti dasar, seperti Id dan Kind, tetapi sebagian besar properti disimpan dalam tas properti di bawah Properties. Oleh karena itu, wadah properti berisi properti yang digunakan untuk mengambil properti dari wadah properti tersebut. Misalnya, gunakan System.ItemNameDisplay untuk sumber properti Nama . Ini adalah kasus properti umum dan terkenal yang memiliki nama yang mudah digunakan. Windows menyediakan beberapa nama yang mudah digunakan ini untuk mempermudah kueri properti.
Saat meminta properti, Anda tidak terbatas pada properti umum dengan nama yang mudah digunakan. Anda dapat menentukan GUID dan ID properti (PID) yang mendasar untuk meminta properti apa pun yang tersedia, bahkan properti kustom yang disediakan oleh perangkat atau driver individual. Format untuk menentukan properti kustom adalah "{GUID} PID". Misalnya: "{744e3bed-3684-4e16-9f8a-07953a8bf2ab} 7".
Note
Anda dapat menemukan daftar GUID properti dalam file header kunci properti perangkat dari driver perangkat.
Beberapa properti umum di semua objek DeviceInformationKind , tetapi sebagian besar unik untuk jenis tertentu. Bagian berikut ini mencantumkan beberapa properti umum yang diurutkan menurut DeviceInformationKind individual. Untuk informasi selengkapnya tentang bagaimana berbagai jenis berhubungan satu sama lain, lihat DeviceInformationKind.
properti DeviceInterface
DeviceInterface adalah objek DeviceInformationKind default dan paling umum yang digunakan dalam skenario aplikasi. Ini adalah jenis objek yang harus Anda gunakan kecuali API perangkat menunjukkan DeviceInformationKind tertentu yang berbeda.
| Name | Type | Deskripsi |
|---|---|---|
| System.Devices.ContainerId | GUID | Identitas DeviceInformationKind.DeviceContainer yang berisi Perangkat yang berisi DeviceInterface ini. Anda dapat meneruskan nilai ini ke CreateFromIdAsync bersama dengan DeviceInformationKind.DeviceContainer untuk menemukan kontainer yang sesuai. |
| System.Devices.InterfaceClassGuid | GUID | GUID kelas antarmuka yang diwakili antarmuka ini. |
| System.Devices.DeviceInstanceId | String | Identitas induk dari DeviceInformationKind.Device. Anda dapat meneruskan nilai ini ke CreateFromIdAsync bersama dengan DeviceInformationKind.Device untuk menemukan perangkat yang sesuai. |
| System.Devices.InterfaceEnabled | Boolean | Menunjukkan apakah antarmuka diaktifkan. DeviceInformation.IsEnabled berasal dari properti ini. |
| System.Devices.GlyphIcon | String | Lokasi ikon untuk glif. |
| System.Devices.IsDefault | Boolean | Menunjukkan apakah ini adalah perangkat default untuk System.Devices.InterfaceClassGuid. Ini terutama digunakan untuk printer. Ini tidak berfungsi untuk audio karena ada beberapa default audio. Gunakan GetDefaultAudioRenderId atau GetDefaultAudioCaptureId untuk mendapatkan default audio. |
| System.Devices.Icon | String | Lokasi ikon. |
| System.ItemNameDisplay | String | Nama tampilan terbaik untuk objek perangkat. |
Properti perangkat
| Name | Type | Deskripsi |
|---|---|---|
| System.Devices.ClassGuid | GUID | Kelas perangkat yang digunakan selama penginstalan perangkat. Untuk informasi selengkapnya, lihat Kelas Penyetelan Perangkat. |
| System.Devices.CompatibleIds | String[] | Id perangkat yang kompatibel. Ini digunakan ketika Windows menentukan driver terbaik untuk diinstal pada perangkat. Untuk informasi selengkapnya, lihat ID yang Kompatibel. |
| System.Devices.ContainerId | GUID | Identitas DeviceInformationKind.DeviceContainer yang menyertakan perangkat ini. Anda dapat meneruskan nilai ini ke CreateFromIdAsync bersama dengan DeviceInformationKind.DeviceContainer untuk menemukan kontainer yang sesuai. |
| System.Devices.DeviceCapabilities | UInt32 | Bitwise-OR dari bendera kemampuan CM_DEVCAP_X yang ditentukan dalam CfgMgr32.h. Untuk informasi selengkapnya, lihat DEVPKEY_Device_Capabilities. |
| System.Devices.DeviceHasProblem | Boolean | Perangkat saat ini memiliki masalah dan kemungkinan tidak berfungsi dengan benar. Ini bisa disebabkan oleh driver yang kedaluarsa, hilang, atau tidak valid. |
| System.Devices.DeviceInstanceId | String | Identitas perangkat. Ini juga merupakan nilai DeviceInformation.Id. |
| System.Devices.DeviceManufacturer | String | Produsen perangkat. |
| System.Devices.HardwareIds | String[] | ID perangkat keras dari perangkat. Windows menggunakan id ini saat menentukan driver terbaik untuk diinstal. Vendor perangkat dapat menggunakan properti ini untuk mengidentifikasi perangkat mereka dari aplikasi mereka. Untuk informasi selengkapnya, lihat ID Perangkat Keras. |
| System.Devices.Parent | String | DeviceInformation.Id dari perangkat induk. Ini adalah induk koneksi, bukan induk DeviceContainer . |
| System.Devices.Present | Boolean | Menunjukkan apakah perangkat saat ini ada dan tersedia. |
| System.ItemNameDisplay | String | Nama tampilan terbaik untuk objek perangkat ini. Dalam hal ini, ini belum tentu nama terbaik untuk pengguna. Nama yang kemungkinan lebih ramah bagi pengguna dapat ditemukan dengan mengacu pada System.ItemNameDisplay dari DeviceContainer atau DeviceInterface yang terkait. |
Properti DeviceContainer
| Name | Type | Deskripsi |
|---|---|---|
| System.Devices.Category | String[] | Daftar deskripsi kategori milik perangkat. Daftar ini disediakan sebagai kategori tunggal. Misalnya, "Tampilan", "Telepon", atau "Perangkat audio". |
| System.Devices.CategoryIds | String[] | Berisi daftar kategori yang dimiliki perangkat ini. Misalnya, Audio.Headphone, Display.Monitor, atau Input.Gaming. |
| System.Devices.CategoryPlural | String[] | Daftar deskripsi kategori milik perangkat. Daftar ini ditampilkan dalam kategori plural. Misalnya, "Tampilan", "Telepon", atau "Perangkat audio". |
| System.Devices.CompatibleIds | String[] | Kumpulan ID yang kompatibel untuk semua objek turunan DeviceInformationKind.Device. |
| System.Devices.Connected | Boolean | Menunjukkan apakah perangkat saat ini tersambung ke sistem atau tidak. |
| System.Devices.GlyphIcon | String | Lokasi ikon untuk glif. |
| System.Devices.HardwareIds | String[] | Kumpulan ID perangkat keras untuk semua objek turunan DeviceInformationKind.Device. |
| System.Devices.Icon | String | Lokasi ikon. |
| System.Devices.LocalMachine | Boolean | Benar jika DeviceContainer ini mewakili sistem itu sendiri, salah jika perangkat berada di luar sistem. |
| System.Devices.Manufacturer | String | Produsen perangkat. |
| System.Devices.ModelName | String | Nama model kontainer perangkat. |
| System.Devices.Paired | Boolean | Menunjukkan apakah salah satu objek DeviceInformationKind.Device anak adalah perangkat nirkabel atau jaringan yang saat ini dipasangkan dengan sistem. |
| System.ItemNameDisplay | String | Nama tampilan terbaik untuk perangkat ini. |
Properti DeviceInterfaceClass
| Name | Type | Deskripsi |
|---|---|---|
| System.ItemNameDisplay | String | Nama tampilan terbaik untuk perangkat ini. |
Properti DevicePanel
| Name | Type | Deskripsi |
|---|---|---|
| System.Devices.Panel.PanelId | String | Pengidentifikasi objek DevicePanel . |
| System.Devices.Panel.PanelGroup | String | Pengidentifikasi PanelGroup induk. |
Properti AssociationEndpoint
| Name | Type | Deskripsi |
|---|---|---|
| System.Devices.Aep.AepId | String | Identitas perangkat ini. Ini juga merupakan nilai DeviceInformation.Id. |
| System.Devices.Aep.CanPair | Boolean | Menunjukkan apakah perangkat dapat dipasangkan dengan sistem atau tidak. DeviceInformationPairing.CanPair berasal dari properti ini. |
| System.Devices.Aep.Category | String[] | Kategori yang mencakup perangkat ini. Misalnya, printer atau kamera. |
| System.Devices.Aep.ContainerId | GUID | ID dari objek induk AssociationEndpointContainer. |
| System.Devices.Aep.DeviceAddress | String | Alamat perangkat. Jika perangkat adalah perangkat jaringan, ini adalah alamat IP. |
| System.Devices.Aep.IsConnected | Boolean | Menunjukkan apakah perangkat saat ini tersambung ke sistem. |
| System.Devices.Aep.IsPaired | Boolean | Menunjukkan apakah perangkat sedang dipasangkan. DeviceInformationPairing.IsPaired berasal dari properti ini. |
| System.Devices.Aep.IsPresent | Boolean | Menunjukkan apakah perangkat saat ini ada, yang berarti perangkat ditayangkan dan ditemukan melalui protokol jaringan atau nirkabel. Setelah perangkat dipasangkan dengan sistem, perangkat di-cache. Setelah ini, perangkat akan ditemukan secara otomatis saat mengkueri objek AssociationEndpoint . Karena itu, Anda tidak dapat hanya mengandalkan penemuan perangkat melalui kueri sebagai indikator apakah perangkat tersebut sedang dapat digunakan atau tidak. Itulah sebabnya properti ini penting. |
| System.Devices.Aep.Manufacturer | String | Produsen perangkat. |
| System.Devices.Aep.ModelId | GUID | Id model perangkat. |
| System.Devices.Aep.ModelName | String | Nama model perangkat. |
| System.Devices.Aep.ProtocolId | GUID | Menunjukkan protokol yang digunakan untuk menemukan perangkat AssocationEndpoint ini. |
| System.Devices.Aep.SignalStrength | Int32 | Kekuatan sinyal perangkat. Properti ini hanya berlaku untuk beberapa protokol. |
| System.ItemNameDisplay | String | Nama tampilan terbaik untuk perangkat. |
Properti AssociationEndpointContainer
| Name | Type | Deskripsi |
|---|---|---|
| System.Devices.AepContainer.Categories | String[] | Kategori yang mencakup perangkat ini. Misalnya, printer atau kamera. |
| System.Devices.AepContainer.Children | String[] | Kumpulan id untuk objek AssocationEndpoint yang merupakan bagian dari kontainer ini. |
| System.Devices.AepContainer.CanPair | Boolean | Menunjukkan apakah salah satu perangkat AssociationEndpoint turunan dapat dipasangkan dengan sistem atau tidak. DeviceInformationPairing.CanPair berasal dari properti ini. |
| System.Devices.AepContainer.ContainerId | GUID | Identitas perangkat ini. Ini juga merupakan nilai DeviceInformation.Id, tetapi dalam bentuk GUID. |
| System.Devices.AepContainer.IsPaired | Boolean | Menunjukkan apakah salah satu perangkat AssociationEndpoint turunan saat ini dipasangkan. DeviceInformationPairing.IsPaired berasal dari properti ini. |
| System.Devices.AepContainer.IsPresent | Boolean | Menunjukkan apakah salah satu perangkat AssociationEndpoint turunan sedang tersedia, yang berarti perangkat tersebut dalam keadaan aktif dan terdeteksi melalui jaringan atau protokol nirkabel. Setelah perangkat dipasangkan dengan sistem, perangkat di-cache. Setelah ini, perangkat akan ditemukan secara otomatis saat mengkueri objek AssociationEndpoint . Karena itu, Anda tidak dapat hanya mengandalkan penemuan perangkat melalui kueri sebagai indikator apakah perangkat tersebut sedang dapat digunakan atau tidak. Itulah sebabnya properti ini penting. |
| System.Devices.AepContainer.Manufacturer | String | Produsen perangkat. |
| System.Devices.AepContainer.ModelIds | String[] | Daftar id model untuk perangkat. Setiap model adalah GUID dalam bentuk string. |
| System.Devices.AepContainer.ModelName | String | Nama model perangkat. |
| System.Devices.AepContainer.ProtocolIds | GUID[] | Daftar id protokol yang telah berkontribusi untuk membangun objek AssociationEndpointContainer ini. Perlu diingat bahwa perangkat AssociationEndpointContainer dibuat dengan mengumpulkan semua perangkat AssociationEndpoint yang ditemukan melalui protokol yang berbeda untuk perangkat fisik yang sama. |
| System.Devices.AepContainer.SupportedUriSchemes | String[] | Daftar skema URI transmisi yang didukung oleh perangkat ini. |
| System.Devices.AepContainer.SupportsAudio | Boolean | Menunjukkan apakah perangkat ini mendukung cast audio. |
| System.Devices.AepContainer.SupportsImages | Boolean | Menunjukkan apakah perangkat ini mendukung transmisi gambar. |
| System.Devices.AepContainer.SupportsVideo | Boolean | Menunjukkan apakah perangkat ini mendukung transmisi video. |
| System.ItemNameDisplay | String | Nama tampilan terbaik untuk perangkat. |
Properti AssociationEndpointService
| Name | Type | Deskripsi |
|---|---|---|
| System.Devices.AepService.AepId | String | Pengidentifikasi objek AssociationEndpoint induk. |
| System.Devices.AepService.ContainerId | GUID | Pengidentifikasi objek AssociationEndpointContainer induk. |
| System.Devices.AepService.ParentAepIsPaired | Boolean | Menunjukkan apakah objek AssociationEndpoint induk dipasangkan dengan sistem. |
| System.Devices.AepService.ProtocolId | GUID | Identitas protokol yang digunakan untuk menemukan perangkat ini. |
| System.Devices.AepService.ServiceClassId | GUID | Identitas layanan yang diwakili oleh perangkat ini. |
| System.Devices.AepService.ServiceId | String | Identitas layanan ini. Ini juga merupakan nilai DeviceInformation.Id. |
| System.ItemNameDisplay | String | Nama tampilan terbaik untuk layanan. |
Berkolaborasi dengan kami di GitHub
Sumber untuk konten ini dapat ditemukan di GitHub, yang juga dapat Anda gunakan untuk membuat dan meninjau masalah dan menarik permintaan. Untuk informasi selengkapnya, lihat panduan kontributor kami.
Windows developer