Cihaz bilgileri özellikleri

Her cihazın belirli bilgilere ihtiyacınız olduğunda veya bir cihaz seçici oluştururken kullanabileceğiniz DeviceInformation özellikleri vardır. Bu özellikleri belirtmek ve numaralandırılmış cihazları belirtilen özelliklerle sınırlamak için Gelişmiş Sorgu Söz Dizimi (AQS) filtresi kullanılabilir. Bu özellikleri, her cihaz için hangi bilgilerin döndürülmesini istediğinizi belirtmek için de kullanabilirsiniz. Bu, uygulamanıza döndürülen cihaz bilgilerini belirtmenizi sağlar.

Cihaz seçicinizde DeviceInformation özelliklerini kullanma hakkında daha fazla bilgi için bkz. Cihaz seçici oluşturma. Bu konu başlığında bilgi özelliklerinin nasıl istendiği gösterilir ve bazı yaygın özellikler açıklanır.

Bir DeviceInformation nesnesi bir kimlikten (DeviceInformation.Id), bir türden (DeviceInformation.Kind) ve bir özellik paketinden (DeviceInformation.Properties) oluşur. DeviceInformation nesnesinin diğer tüm özellikleri Özellikler özellik paketinden türetilir. Örneğin, NameSystem.ItemNameDisplay'den türetilir. Bu, özellik paketinin her zaman diğer özellikleri belirlemek için gerekli bilgileri içerdiği anlamına gelir.

Özellikler isteniyor

DeviceInformation nesnesinin bazı temel özellikleri vardır, Id ve Kind gibi, ancak özelliklerin çoğu Properties altındaki bir özellik paketinde depolanır. Bu nedenle özellik paketi, özellikleri özellik paketinden kaynak olarak almak için kullanılan özellikleri içerir. Örneğin, Name özelliğini kaynak yapmak için System.ItemNameDisplay kullanın. Bu, kullanıcı dostu bir ada sahip yaygın ve iyi bilinen bir özelliğin durumudur. Windows, özellikleri sorgulamayı kolaylaştırmak için bu kullanıcı dostu adlardan birkaçını sağlar.

Özellikler istediğinizde, kullanımı kolay adlara sahip ortak özelliklerle sınırlı olmazsınız. Tek bir cihaz veya sürücü tarafından sağlanan özel özellikler bile olmak üzere kullanılabilir olan herhangi bir özelliği istemek için temel alınan GUID ve özellik kimliğini (PID) belirtebilirsiniz. Özel özellik belirtme biçimi "{GUID} PID"dir. Örneğin: "{744e3bed-3684-4e16-9f8a-07953a8bf2ab} 7".

Note

Özellik GUID'lerinin listesini, cihaz sürücüsünün cihaz özellik anahtarı üst bilgi dosyasında bulabilirsiniz.

Bazı özellikler tüm DeviceInformationKind nesneleri arasında ortaktır, ancak çoğu belirli bir tür için benzersizdir. Aşağıdaki bölümlerde, tek tek DeviceInformationKind'e göre sıralanmış bazı yaygın özellikler listelenmiştir. Farklı türlerin birbiriyle ilişkisi hakkında daha fazla bilgi için bkz. DeviceInformationKind.

DeviceInterface özellikleri

DeviceInterface , uygulama senaryolarında kullanılan varsayılan ve en yaygın DeviceInformationKind nesnesidir. Bu, cihaz API'sinde farklı bir DeviceInformationKind belirtilmediği sürece kullanmanız gereken nesne türüdür.

Name Type Description
System.Devices.ContainerId GUID Bu DeviceInterface öğesini içeren Device öğesini barındıran DeviceInformationKind.DeviceContainer kimliği. Uygun kapsayıcıyı bulmak için bu değeri DeviceInformationKind.DeviceContainer ile birlikte CreateFromIdAsync'e geçirebilirsiniz.
System.Devices.InterfaceClassGuid GUID Bu arabirimin temsil ettiği arabirim sınıfı GUID'i.
System.Devices.DeviceInstanceId String DeviceInformationKind.Device üst öğesinin kimliği. Uygun cihazı bulmak için bu değeri DeviceInformationKind.Device ile birlikte CreateFromIdAsync'e geçirebilirsiniz.
System.Devices.InterfaceEnabled Boolean Arabirimin etkinleştirilip etkinleştirilmediğini gösterir. DeviceInformation.IsEnabled bu özellikten türetilir.
System.Devices.GlyphIcon String Glif için simge yolu.
System.Devices.IsDefault Boolean Bunun System.Devices.InterfaceClassGuid için varsayılan cihaz olup olmadığını gösterir. Bu, çoğunlukla yazıcılar için kullanılır. Birden çok ses varsayılanı olduğundan bu, ses için çalışmaz. Ses varsayılanlarını almak için GetDefaultAudioRenderId veya GetDefaultAudioCaptureId kullanın.
System.Devices.Icon String Simge yolu.
System.ItemNameDisplay String Cihaz nesnesi için en uygun görünen ad.

 

Cihaz özellikleri

Name Type Description
System.Devices.ClassGuid GUID Cihaz yüklemesi sırasında kullanılan cihaz sınıfı. Daha fazla bilgi için bkz. Cihaz Kurulum Sınıfları.
System.Devices.CompatibleIds String[] Cihazın uyumlu kimlikleri. Bunlar, Windows cihaza yüklenecek en iyi sürücüyü belirlerken kullanılır. Daha fazla bilgi için bkz . Uyumlu Kimlik.
System.Devices.ContainerId GUID Bu cihazı içeren DeviceInformationKind.DeviceContainer'ın kimliği. Uygun kapsayıcıyı bulmak için bu değeri DeviceInformationKind.DeviceContainer ile birlikte CreateFromIdAsync'e geçirebilirsiniz.
System.Devices.DeviceCapabilities UInt32 CfgMgr32.h içinde tanımlanan CM_DEVCAP_X yetenek bayraklarının bit düzeyinde VEYA işlemi. Daha fazla bilgi için bkz. DEVPKEY_Device_Capabilities.
System.Devices.DeviceHasProblem Boolean Cihazda şu anda bir sorun var ve büyük olasılıkla düzgün çalışmıyor. Bunun nedeni güncel olmayan, eksik veya geçersiz bir sürücü olabilir.
System.Devices.DeviceInstanceId String Cihazın kimliği. Bu aynı zamanda DeviceInformation.Id değeridir.
System.Devices.DeviceManufacturer String Cihazın üreticisi.
System.Devices.HardwareIds String[] Cihazın donanım kimlikleri. Windows, yüklenecek en iyi sürücüyü belirlerken bu kimlikleri kullanır. Cihaz satıcıları, cihazlarını kendi uygulamalarından tanımlamak için bu özelliği kullanabilir. Daha fazla bilgi için bkz . Donanım Kimliği.
System.Devices.Parent String Üst cihazın DeviceInformation.Id. Bu, DeviceContainer üst öğesi değil, bağlantı üst öğesidir.
System.Devices.Present Boolean Cihazın şu anda mevcut ve kullanılabilir olup olmadığını gösterir.
System.ItemNameDisplay String Bu cihaz nesnesi için en iyi görünen ad. Bu durumda, bunun kullanıcılar için en iyi ad olması şart değildir. Kullanıcı dostu bir ad için daha olası bir aday, ilişkili DeviceContainer veya DeviceInterface öğesinin System.ItemNameDisplay öğesine başvurarak bulunabilir.

 

DeviceContainer özellikleri

Name Type Description
System.Devices.Category String[] Cihazın ait olduğu kategorilerin açıklamalarının listesi. Bu liste tekil kategoriler olarak sağlanır. Örneğin, "Ekran", "Telefon" veya "Ses cihazı".
System.Devices.CategoryIds String[] Bu cihazın ait olduğu kategorilerin listesini içerir. Örneğin, Audio.Headphone, Display.Monitor veya Input.Gaming.
System.Devices.CategoryPlural String[] Cihazın ait olduğu kategorilerin açıklamalarının listesi. Bu liste çoğul kategoriler olarak sağlanır. Örneğin, "Görüntüler", "Telefonlar" veya "Ses cihazları".
System.Devices.CompatibleIds String[] Tüm alt DeviceInformationKind.Device nesneleri için uyumlu kimliklerin koleksiyonu.
System.Devices.Connected Boolean Cihazın şu anda sisteme bağlı olup olmadığını gösterir.
System.Devices.GlyphIcon String Glif için simge yolu.
System.Devices.HardwareIds String[] Tüm alt DeviceInformationKind.Device nesneleri için donanım kimlikleri koleksiyonu.
System.Devices.Icon String Simge yolu.
System.Devices.LocalMachine Boolean Bu DeviceContainer sistemin kendisini temsil ederse True, cihaz sistemin dışındaysa false.
System.Devices.Manufacturer String Cihazın üreticisi.
System.Devices.ModelName String Cihaz kapsayıcısının model adı.
System.Devices.Paired Boolean DeviceInformationKind.Device nesnelerinden herhangi birinin şu anda sistemle eşleştirilmiş kablosuz veya ağ cihazları olup olmadığını gösterir.
System.ItemNameDisplay String Bu cihaz için en uygun görünen ad.

 

DeviceInterfaceClass özellikleri

Name Type Description
System.ItemNameDisplay String Bu cihaz için en uygun görünen ad.

 

DevicePanel özellikleri

Name Type Description
System.Devices.Panel.PanelId String DevicePanel nesnesinin tanımlayıcısı.
System.Devices.Panel.PanelGroup String PanelGroup üst öğesinin tanımlayıcısı.

AssociationEndpoint özellikleri

Name Type Description
System.Devices.Aep.AepId String Bu cihazın kimliği. Bu aynı zamanda DeviceInformation.Id değeridir.
System.Devices.Aep.CanPair Boolean Cihazın sistemle eşleştirilip eşleştirilmediğini gösterir. DeviceInformationPairing.CanPair bu özellikten türetilir.
System.Devices.Aep.Category String[] Cihazın parçası olduğu kategoriler. Örneğin, yazıcı veya kamera.
System.Devices.Aep.ContainerId GUID Üst AssociationEndpointContainer nesnesinin kimliği.
System.Devices.Aep.DeviceAddress String Cihazın adresi. Cihaz bir ağ cihazıysa, bu IP adresidir.
System.Devices.Aep.IsConnected Boolean Cihazın şu anda sisteme bağlı olup olmadığını gösterir.
System.Devices.Aep.IsPaired Boolean Cihazın şu anda eşlenmiş olup olmadığını gösterir. DeviceInformationPairing.IsPaired bu özellikten türetilir.
System.Devices.Aep.IsPresent Boolean Cihazın şu anda mevcut olup olmadığını gösterir, yani cihazın canlı olduğu ve ağ veya kablosuz protokol üzerinden bulunduğu anlamına gelir. Bir cihaz sistemle eşleştirildikten sonra cihaz önbelleğe alınır. Bundan sonra, AssociationEndpoint nesneleri sorgulanırken cihaz otomatik olarak bulunur. Bu nedenle, cihazın şu anda kullanılabilir olup olmadığını belirtmek için yalnızca bir sorguyla cihazı bulmaya güvenemezsiniz. Bu nedenle bu özellik önemlidir.
System.Devices.Aep.Manufacturer String Cihazın üreticisi.
System.Devices.Aep.ModelId GUID Cihazın model kimliği.
System.Devices.Aep.ModelName String Cihazın model adı.
System.Devices.Aep.ProtocolId GUID Bu AssocationEndpoint cihazını bulmak için kullanılan protokolü gösterir.
System.Devices.Aep.SignalStrength Int32 Cihazın sinyal gücü. Bu özellik yalnızca bazı protokoller için geçerlidir.
System.ItemNameDisplay String Cihaz için en uygun görünen isim.

 

AssociationEndpointContainer özellikleri

Name Type Description
System.Devices.AepContainer.Categories String[] Cihazın parçası olduğu kategoriler. Örneğin, yazıcı veya kamera.
System.Devices.AepContainer.Children String[] Bu kapsayıcının parçası olan AssocationEndpoint nesneleri için kimlik koleksiyonu.
System.Devices.AepContainer.CanPair Boolean AssociationEndpoint alt aygıtlarından birinin sistemle eşleştirilip eşleştirilemeyeceğini gösterir. DeviceInformationPairing.CanPair bu özellikten türetilir.
System.Devices.AepContainer.ContainerId GUID Bu cihazın kimliği. Bu aynı zamanda DeviceInformation.Id değeridir ancak GUID biçimindedir.
System.Devices.AepContainer.IsPaired Boolean AssociationEndpoint alt cihazlarından birinin şu anda eşleştirilmiş olup olmadığını gösterir. DeviceInformationPairing.IsPaired bu özellikten türetilir.
System.Devices.AepContainer.IsPresent Boolean Alt AssociationEndpoint aygıtlarından birinin şu anda mevcut olup olmadığını gösterir; bu, aygıtın etkin olduğu ve ağ ya da kablosuz protokol üzerinden algılandığı anlamına gelir. Bir cihaz sistemle eşleştirildikten sonra cihaz önbelleğe alınır. Bundan sonra, AssociationEndpoint nesneleri sorgulanırken cihaz otomatik olarak bulunur. Bu nedenle, cihazın şu anda kullanılabilir olup olmadığını belirtmek için yalnızca bir sorguyla cihazı bulmaya güvenemezsiniz. Bu nedenle bu özellik önemlidir.
System.Devices.AepContainer.Manufacturer String Cihazın üreticisi.
System.Devices.AepContainer.ModelIds String[] Cihaza ait model kimliklerinin listesi. Her model dize biçiminde bir GUID'dir.
System.Devices.AepContainer.ModelName String Cihazın model adı.
System.Devices.AepContainer.ProtocolIds GUID[] Bu AssociationEndpointContainer nesnesinin oluşturulmasına katkıda bulunan protokol kimliklerinin listesi. Bir AssociationEndpointContainer cihazının, aynı fiziksel cihaz için farklı protokoller üzerinde bulunan tüm AssociationEndpoint cihazları toplanarak oluşturulduğunu unutmayın.
System.Devices.AepContainer.SupportedUriSchemes String[] Bu cihaz tarafından desteklenen atama URI düzenlerinin listesi.
System.Devices.AepContainer.SupportsAudio Boolean Bu cihazın ses atamayı desteklenip desteklemediğini gösterir.
System.Devices.AepContainer.SupportsImages Boolean Bu cihazın görüntü atamayı desteklediğini gösterir.
System.Devices.AepContainer.SupportsVideo Boolean Bu cihazın video yayınlamayı desteklediğini gösterir.
System.ItemNameDisplay String Cihaz için en uygun görünen isim.

 

AssociationEndpointService özellikleri

Name Type Description
System.Devices.AepService.AepId String Üst AssociationEndpoint nesnesinin tanımlayıcısı.
System.Devices.AepService.ContainerId GUID Ana AssociationEndpointContainer nesnesinin tanımlayıcısı.
System.Devices.AepService.ParentAepIsPaired Boolean Üst AssociationEndpoint nesnesinin sistemle eşleştirilip eşlenmediğini gösterir.
System.Devices.AepService.ProtocolId GUID Bu cihazı bulmak için kullanılan protokolün kimliği.
System.Devices.AepService.ServiceClassId GUID Bu cihaz tarafından temsil edilen hizmetin kimliği.
System.Devices.AepService.ServiceId String Bu hizmetin kimliği. Bu aynı zamanda DeviceInformation.Id değeridir.
System.ItemNameDisplay String Hizmet için en uygun görünen ad.
  • Last updated on