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.