Properti informasi perangkat
API Penting
Setiap perangkat memiliki properti DeviceInformation terkait yang dapat Anda gunakan saat Anda membutuhkan informasi tertentu atau saat Anda sedang membangun pemilih perangkat. Properti ini dapat ditentukan filter AQS untuk membatasi perangkat yang Anda beri nama untuk menemukan perangkat dengan sifat yang ditentukan. Anda juga dapat menggunakan properti ini untuk menunjukkan informasi apa yang ingin Anda kembalikan untuk setiap perangkat. Itu memungkinkan Anda untuk menentukan informasi perangkat yang dikembalikan ke aplikasi Anda.
Untuk informasi selengkapnya tentang menggunakan properti DeviceInformation di pemilih perangkat Anda, lihat Membuat pemilih perangkat. Topik ini membahas cara meminta properti informasi dan juga mencantumkan beberapa properti umum dan tujuannya.
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 lainnya.
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 mencari properti Nama . Ini adalah kasus properti umum dan terkenal yang memiliki nama yang ramah pengguna. Windows menyediakan beberapa nama yang mudah digunakan ini untuk mempermudah kueri properti.
Saat Anda meminta properti, Anda tidak terbatas pada properti umum dengan nama yang ramah pengguna. Anda dapat menentukan GUID dan ID properti (PID) yang mendasarinya 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 dari driver perangkat.
Beberapa properti umum di semua objek DeviceInformationKind , tetapi sebagian besar unik untuk jenis tertentu. Bagian berikut mencantumkan beberapa properti umum yang diurutkan berdasarkan 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 | Jenis | 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 | Kelas antarmuka GUID 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 mesin terbang. |
| 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 | Jenis | 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 saat 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 | Sedikitwise-OR dari CM_DEVCAP_X kemampuan bendera yang didefinisikan dalam CfgMgr32.h. Untuk informasi lebih lanjut, 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 sudah ketinggalan zaman, hilang, atau tidak valid. |
| System.Devices.DeviceInstanceId | String | Identitas perangkat. Ini juga nilai DeviceInformation.Id. |
| System.Devices.DeviceManufacturer | String | Produsen perangkat. |
| System.Devices.HardwareIds | String[] | Id perangkat keras 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 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 ramah pengguna dapat ditemukan dengan mereferensikan System.ItemNameDisplay dari DeviceContainer atau DeviceInterface terkait. |
Properti DeviceContainer
| Nama | Jenis | Deskripsi |
|---|---|---|
| System.Devices.Category | String[] | Daftar deskripsi kategori milik perangkat. Daftar ini disediakan sebagai kategori tunggal. Misalnya, "Tampilkan", "Telepon", atau "Perangkat audio". |
| System.Devices.CategoryIds | String[] | Berisi daftar kategori milik perangkat ini. Misalnya, Audio.Headphone, Display.Monitor, atau Input.Gaming. |
| System.Devices.CategoryPlural | String[] | Daftar deskripsi kategori milik perangkat. Daftar ini disediakan sebagai kategori jamak. Misalnya, "Menampilkan", "Ponsel", atau "Perangkat audio". |
| System.Devices.CompatibleIds | String[] | Kumpulan id yang kompatibel untuk semua objek DeviceInformationKind.Device anak. |
| System.Devices.Connected | Boolean | Menunjukkan apakah perangkat saat ini terhubung ke sistem atau tidak. |
| System.Devices.GlyphIcon | String | Jalur ikon untuk mesin terbang. |
| System.Devices.HardwareIds | String[] | 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 wadah 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 | Jenis | Deskripsi |
|---|---|---|
| System.ItemNameDisplay | String | Nama tampilan terbaik untuk perangkat ini. |
Properti DevicePanel
| Nama | Jenis | Deskripsi |
|---|---|---|
| System.Devices.Panel.PanelId | String | Pengidentifikasi objek DevicePanel . |
| System.Devices.Panel.PanelGroup | String | Pengidentifikasi PanelGroup induk. |
Properti AssociationEndpoint
| Nama | Jenis | Deskripsi |
|---|---|---|
| System.Devices.Aep.AepId | String | Identitas perangkat ini. Ini juga 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 menjadi bagian dari perangkat. 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 terhubung 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 hidup dan ditemukan melalui jaringan atau protokol nirkabel. Setelah perangkat dipasangkan dengan sistem, perangkat di-cache. Setelah ini, perangkat akan secara otomatis ditemukan saat mengkueri objek AssociationEndpoint . Karena itu, Anda tidak dapat mengandalkan hanya menemukan perangkat dengan kueri untuk menunjukkan apakah saat ini dapat digunakan atau tidak. Itulah mengapa 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 | Jenis | Deskripsi |
|---|---|---|
| System.Devices.AepContainer.Categories | String[] | Kategori yang menjadi bagian dari perangkat. Misalnya, printer atau kamera. |
| System.Devices.AepContainer.Anak-anak | String[] | Kumpulan id untuk objek AssocationEndpoint yang merupakan bagian dari kontainer ini. |
| System.Devices.AepContainer.CanPair | Boolean | Menunjukkan apakah salah satu perangkat AssociationEndpoint anak 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 anak 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 ini hidup dan ditemukan melalui jaringan atau protokol nirkabel. Setelah perangkat dipasangkan dengan sistem, perangkat di-cache. Setelah ini, perangkat akan secara otomatis ditemukan saat mengkueri objek AssociationEndpoint . Karena itu, Anda tidak dapat mengandalkan hanya menemukan perangkat dengan kueri untuk menunjukkan apakah saat ini dapat digunakan atau tidak. Itulah mengapa 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 di atas protokol yang berbeda untuk perangkat fisik yang sama. |
| System.Devices.AepContainer.SupportedUriSchemes | String[] | Daftar skema casting URI yang didukung oleh perangkat ini. |
| System.Devices.AepContainer.SupportsAudio | Boolean | Menunjukkan apakah perangkat ini mendukung casting audio. |
| System.Devices.AepContainer.SupportsImages | Boolean | Menunjukkan apakah perangkat ini mendukung casting gambar. |
| System.Devices.AepContainer.MendukungVideo | Boolean | Menunjukkan apakah perangkat ini mendukung casting video. |
| System.ItemNameDisplay | String | Nama tampilan terbaik untuk perangkat. |
Properti AssociationEndpointService
| Nama | Jenis | 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 nilai DeviceInformation.Id. |
| System.ItemNameDisplay | String | Nama tampilan terbaik untuk layanan ini. |