Properti informasi perangkat
Setiap perangkat memiliki properti DeviceInformation terkait yang dapat Anda gunakan saat memerlukan informasi tertentu atau saat Anda membangun 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
Untuk informasi selengkapnya tentang menggunakan properti DeviceInformation di 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 tas properti Properti . 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 Properti. Karena itu, tas properti berisi properti yang digunakan untuk sumber properti dari tas properti. 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".
Catatan
Anda dapat menemukan daftar GUID properti di file header kunci properti perangkat 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.
| Nama | Tipe | 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 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 | Jalur ikon untuk glyph. |
| 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 | Jalur ikon. |
| System.ItemNameDisplay | String | Nama tampilan terbaik untuk objek perangkat. |
Properti perangkat
| Nama | Tipe | Deskripsi |
|---|---|---|
| System.Devices.ClassGuid | GUID | Kelas perangkat yang digunakan selama penginstalan perangkat. Untuk informasi selengkapnya, lihat Kelas Penyetelan Perangkat. |
| System.Devices.CompatibleIds | Tali[] | Id perangkat yang kompatibel. Ini digunakan ketika Windows menentukan pengandar 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 | Tali[] | Id perangkat keras perangkat. Windows menggunakan id ini ketika menentukan pengandar 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 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. Kandidat yang lebih mungkin untuk nama yang mudah digunakan dapat ditemukan dengan merujuk System.ItemNameDisplay dari DeviceContainer atau DeviceInterface terkait. |
Properti DeviceContainer
| Nama | Tipe | Deskripsi |
|---|---|---|
| System.Devices.Category | Tali[] | Daftar deskripsi kategori milik perangkat. Daftar ini disediakan sebagai kategori tunggal. Misalnya, "Tampilan", "Telepon", atau "Perangkat audio". |
| System.Devices.CategoryIds | Tali[] | Berisi daftar kategori yang dimiliki perangkat ini. Misalnya, Audio.Headphone, Display.Monitor, atau Input.Gaming. |
| System.Devices.CategoryPlural | Tali[] | Daftar deskripsi kategori milik perangkat. Daftar ini disediakan sebagai kategori jamak. Misalnya, "Tampilan", "Telepon", atau "Perangkat audio". |
| System.Devices.CompatibleIds | Tali[] | Kumpulan id yang kompatibel untuk semua objek DeviceInformationKind.Device anak. |
| System.Devices.Connected | Boolean | Menunjukkan apakah perangkat saat ini tersambung ke sistem atau tidak. |
| System.Devices.GlyphIcon | String | Jalur ikon untuk glyph. |
| System.Devices.HardwareIds | Tali[] | Kumpulan id perangkat keras untuk semua objek DeviceInformationKind.Device anak. |
| System.Devices.Icon | String | Jalur 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
| Nama | Tipe | Deskripsi |
|---|---|---|
| System.ItemNameDisplay | String | Nama tampilan terbaik untuk perangkat ini. |
Properti DevicePanel
| Nama | Tipe | Deskripsi |
|---|---|---|
| System.Devices.Panel.PanelId | String | Pengidentifikasi objek DevicePanel . |
| System.Devices.Panel.PanelGroup | String | Pengidentifikasi PanelGroup induk. |
Properti AssociationEndpoint
| Nama | Tipe | 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 | Tali[] | Kategori tempat perangkat menjadi bagian dari. Misalnya, printer atau kamera. |
| System.Devices.Aep.ContainerId | GUID | Id objek AssociationEndpointContainer induk. |
| 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 saat ini 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 mengandalkan hanya menemukan perangkat dengan kueri untuk menunjukkan apakah perangkat saat ini 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
| Nama | Tipe | Deskripsi |
|---|---|---|
| System.Devices.AepContainer.Categories | Tali[] | Kategori tempat perangkat menjadi bagian dari. Misalnya, printer atau kamera. |
| System.Devices.AepContainer.Children | Tali[] | 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 anak saat ini ada, yang berarti perangkat sedang aktif dan ditemukan 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 mengandalkan hanya menemukan perangkat dengan kueri untuk menunjukkan apakah perangkat saat ini dapat digunakan atau tidak. Itulah sebabnya properti ini penting. |
| System.Devices.AepContainer.Manufacturer | String | Produsen perangkat. |
| System.Devices.AepContainer.ModelIds | Tali[] | 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 | Tali[] | Daftar skema URI transmisi yang didukung oleh perangkat ini. |
| System.Devices.AepContainer.SupportsAudio | Boolean | Menunjukkan apakah perangkat ini mendukung transmisi 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
| Nama | Tipe | 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. |