Eigenschappen van apparaatgegevens

Elk apparaat heeft DeviceInformation eigenschappen die u kunt gebruiken wanneer u specifieke informatie nodig hebt of wanneer u een apparaatkiezer bouwt. Een AQS-filter (Advanced Query Syntax) kan worden gebruikt om deze eigenschappen op te geven en de geïnventareerde apparaten met de opgegeven eigenschappen te beperken. U kunt deze eigenschappen ook gebruiken om aan te geven welke informatie u voor elk apparaat wilt retourneren. Hiermee kunt u de apparaatgegevens opgeven die naar uw toepassing worden geretourneerd.

Zie Build a device selector voor meer informatie over het gebruik van eigenschappen van DeviceInformation in uw apparaatkiesfunctie. In dit onderwerp wordt beschreven hoe u informatie-eigenschappen aanvraagt en een aantal algemene eigenschappen beschrijft.

Een object DeviceInformation bestaat uit een identiteit (DeviceInformation.Id), een soort (DeviceInformation.Kind) en een eigenschappentas (DeviceInformation.Properties). Alle andere eigenschappen van een DeviceInformation-object zijn afgeleid van de eigenschappenverzameling. De naam is bijvoorbeeld afgeleid van System.ItemNameDisplay. Dit betekent dat de eigenschappentas altijd de informatie bevat die nodig is om de andere eigenschappen te bepalen.

Eigenschappen aanvragen

Een DeviceInformation-object heeft enkele basiseigenschappen, zoals Id en Kind, maar de meeste eigenschappen worden opgeslagen in een eigenschappentas onder Properties. Hierdoor bevat de eigenschappentas de eigenschappen die worden gebruikt om de eigenschappen uit de eigenschappentas te halen. Gebruik bijvoorbeeld System.ItemNameDisplay om de eigenschap Name te bronen. Dit is een geval van een algemene en bekende eigenschap met een gebruiksvriendelijke naam. Windows biedt verschillende van deze gebruiksvriendelijke namen om het uitvoeren van query's voor eigenschappen eenvoudiger te maken.

Wanneer u eigenschappen aanvraagt, bent u niet beperkt tot de algemene eigenschappen met gebruiksvriendelijke namen. U kunt de onderliggende GUID en eigenschaps-id (PID) opgeven om een eigenschap aan te vragen die beschikbaar is, zelfs aangepaste eigenschappen die worden geleverd door een afzonderlijk apparaat of stuurprogramma. De indeling voor het opgeven van een aangepaste eigenschap is '{GUID} PID'. Bijvoorbeeld: "{744e3bed-3684-4e16-9f8a-07953a8bf2ab} 7".

Note

U vindt de lijst met GUID's van eigenschappen in het headerbestand met apparaateigenschapssleutels van het apparaatstuurprogramma.

Sommige eigenschappen zijn gebruikelijk voor alle DeviceInformationKind-objecten , maar de meeste eigenschappen zijn uniek voor een bepaald type. In de volgende secties worden enkele algemene eigenschappen weergegeven die zijn gesorteerd op het afzonderlijke DeviceInformationKind. Zie DeviceInformationKind voor meer informatie over de relatie tussen de verschillende soorten.

Eigenschappen van DeviceInterface

DeviceInterface is het standaardobject en meest voorkomende DeviceInformationKind-object dat wordt gebruikt in app-scenario's. Dit is het type object dat u moet gebruiken, tenzij de apparaat-API een ander specifiek DeviceInformationKind aangeeft.

Name Typ Description
System.Devices.ContainerId GUID Identiteit van de DeviceInformationKind.DeviceContainer die het apparaat bevat dat deze DeviceInterface bevat. U kunt deze waarde doorgeven aan CreateFromIdAsync samen met DeviceInformationKind.DeviceContainer om de juiste container te vinden.
System.Devices.InterfaceClassGuid GUID De GUID van de interfaceklasse die deze interface vertegenwoordigt.
System.Devices.DeviceInstanceId String Identiteit van de bovenliggende DeviceInformationKind.Device. U kunt deze waarde doorgeven aan CreateFromIdAsync samen met DeviceInformationKind.Device om het juiste apparaat te vinden.
System.Devices.InterfaceEnabled Boolean Geeft aan of de interface is ingeschakeld. DeviceInformation.IsEnabled is afgeleid van deze eigenschap.
System.Devices.GlyphIcon String Pictogrampad voor de glyph.
System.Devices.IsDefault Boolean Geeft aan of dit het standaardapparaat is voor System.Devices.InterfaceClassGuid. Dit wordt voornamelijk gebruikt voor printers. Dit werkt niet voor audio omdat er meerdere standaardwaarden voor audio zijn. Gebruik GetDefaultAudioRenderId of GetDefaultAudioCaptureId om standaardinstellingen voor audio op te halen.
System.Devices.Icon String Pad naar pictogram.
System.ItemNameDisplay String De beste weergavenaam voor het apparaatobject.

 

Apparaateigenschappen

Name Typ Description
System.Devices.ClassGuid GUID Apparaatklasse die wordt gebruikt tijdens de installatie van het apparaat. Zie Apparaatinstallatieklassen voor meer informatie.
System.Devices.CompatibleIds string[] De compatibele id's van het apparaat. Deze worden gebruikt wanneer Windows het beste stuurprogramma bepaalt dat op het apparaat moet worden geïnstalleerd. Zie Compatibele id voor meer informatie.
System.Devices.ContainerId GUID Identiteit van de DeviceInformationKind.DeviceContainer die dit apparaat bevat. U kunt deze waarde doorgeven aan CreateFromIdAsync samen met DeviceInformationKind.DeviceContainer om de juiste container te vinden.
System.Devices.DeviceCapabilities UInt32 Een bitgewijze OF van de CM_DEVCAP_X-mogelijkheidsvlaggen zoals gedefinieerd in CfgMgr32.h. Zie DEVPKEY_Device_Capabilities voor meer informatie.
System.Devices.DeviceHasProblem Boolean Het apparaat heeft momenteel een probleem en werkt waarschijnlijk niet goed. Dit kan worden veroorzaakt door een verouderd, ontbrekend of ongeldig stuurprogramma.
System.Devices.DeviceInstanceId String De identiteit van het apparaat. Dit is ook de waarde van DeviceInformation.Id.
System.Devices.DeviceManufacturer String De fabrikant van het apparaat.
System.Devices.HardwareIds string[] De hardware-id's van het apparaat. Windows gebruikt deze id's bij het bepalen van het beste stuurprogramma dat moet worden geïnstalleerd. Apparaatleveranciers kunnen deze eigenschap gebruiken om hun apparaat te identificeren vanuit hun app. Zie Hardware-id voor meer informatie.
System.Devices.Parent String De DeviceInformation.Id van het bovenliggende apparaat. Dit is de parent van de verbinding, niet de parent van de DeviceContainer.
System.Devices.Present Boolean Geeft aan of het apparaat momenteel aanwezig en beschikbaar is.
System.ItemNameDisplay String De beste weergavenaam voor dit apparaatobject. In dit geval is dit niet noodzakelijkerwijs de beste naam voor gebruikers. Een meer waarschijnlijke kandidaat voor een gebruiksvriendelijke naam is te vinden door te verwijzen naar het System.ItemNameDisplay van de bijbehorende DeviceContainer of DeviceInterface.

 

Eigenschappen van DeviceContainer

Name Typ Description
System.Devices.Category string[] Een lijst met beschrijvingen van de categorieën waartoe het apparaat behoort. Deze lijst wordt geleverd als enkelvoudige categorieën. Bijvoorbeeld "Beeldscherm", "Telefoon" of "audioapparaat".
System.Devices.CategoryIds string[] Bevat een lijst met categorieën waartoe dit apparaat behoort. Bijvoorbeeld Audio.Headphone, Display.Monitor of Input.Gaming.
System.Devices.CategoryPlural string[] Een lijst met beschrijvingen van de categorieën waartoe het apparaat behoort. Deze lijst wordt weergegeven als categorieën voor meervoud. Bijvoorbeeld 'Beeldschermen', 'Telefoons' of 'Audioapparaten'.
System.Devices.CompatibleIds string[] De verzameling van compatibele id’s voor alle onderliggende DeviceInformationKind.Device-objecten.
System.Devices.Connected Boolean Hiermee wordt aangegeven of het apparaat momenteel is verbonden met het systeem of niet.
System.Devices.GlyphIcon String Pictogrampad voor de glyph.
System.Devices.HardwareIds string[] De verzameling hardware-id's voor alle onderliggende objecten van het type DeviceInformationKind.Device.
System.Devices.Icon String Pad naar pictogram.
System.Devices.LocalMachine Boolean Waar als deze DeviceContainer het systeem zelf vertegenwoordigt, onwaar als het apparaat zich buiten het systeem bevindt.
System.Devices.Manufacturer String De fabrikant van het apparaat.
System.Devices.ModelName String Modelnaam van de apparaatcontainer.
System.Devices.Paired Boolean Geeft aan of een van de onderliggende DeviceInformationKind.Device-objecten draadloze of netwerkapparaten zijn die momenteel zijn gekoppeld aan het systeem.
System.ItemNameDisplay String De beste weergavenaam voor dit apparaat.

 

Eigenschappen van DeviceInterfaceClass

Name Typ Description
System.ItemNameDisplay String De beste weergavenaam voor dit apparaat.

 

Eigenschappen van DevicePanel

Name Typ Description
System.Devices.Panel.PanelId String De id van het DevicePanel-object .
System.Devices.Panel.PanelGroup String De id van de bovenliggende PanelGroup.

Eigenschappen van AssociationEndpoint

Name Typ Description
System.Devices.Aep.AepId String Identiteit van dit apparaat. Dit is ook de waarde van DeviceInformation.Id.
System.Devices.Aep.CanPair Boolean Geeft aan of het apparaat wel of niet kan worden gekoppeld aan het systeem. DeviceInformationPairing.CanPair is afgeleid van deze eigenschap.
System.Devices.Aep.Category string[] De categorieën waarvan het apparaat deel uitmaakt. Bijvoorbeeld printer of camera.
System.Devices.Aep.ContainerId GUID De id van het bovenliggende AssociationEndpointContainer-object.
System.Devices.Aep.DeviceAddress String Het adres van het apparaat. Als het apparaat een netwerkapparaat is, is dit het IP-adres.
System.Devices.Aep.IsConnected Boolean Geeft aan of het apparaat momenteel is verbonden met het systeem.
System.Devices.Aep.IsPaired Boolean Geeft aan of het apparaat momenteel is gekoppeld. DeviceInformationPairing.IsPaired is afgeleid van deze eigenschap.
System.Devices.Aep.IsPresent Boolean Geeft aan of het apparaat momenteel aanwezig is, wat betekent dat het apparaat live is en wordt gedetecteerd via het netwerk of draadloze protocol. Zodra een apparaat is gekoppeld aan het systeem, wordt het apparaat in de cache opgeslagen. Hierna wordt het apparaat automatisch gedetecteerd bij het uitvoeren van query's op AssociationEndpoint-objecten . Daarom kunt u niet vertrouwen op het detecteren van het apparaat met een query om aan te geven of het momenteel bruikbaar is. Daarom is deze eigenschap belangrijk.
System.Devices.Aep.Manufacturer String De fabrikant van het apparaat.
System.Devices.Aep.ModelId GUID De model-id van het apparaat.
System.Devices.Aep.ModelName String De modelnaam van het apparaat.
System.Devices.Aep.ProtocolId GUID Geeft het protocol aan dat wordt gebruikt om dit AssocationEndpoint-apparaat te detecteren.
System.Devices.Aep.SignalStrength Int32 De signaalsterkte van het apparaat. Deze eigenschap is alleen van toepassing op sommige protocollen.
System.ItemNameDisplay String De beste weergavenaam voor het apparaat.

 

Eigenschappen van AssociationEndpointContainer

Name Typ Description
System.Devices.AepContainer.Categories string[] De categorieën waarvan het apparaat deel uitmaakt. Bijvoorbeeld printer of camera.
System.Devices.AepContainer.Children string[] De verzameling id's voor de AssocationEndpoint-objecten die deel uitmaken van deze container.
System.Devices.AepContainer.CanPair Boolean Geeft aan of een van de onderliggende AssociationEndpoint-apparaten al dan niet aan het systeem kan worden gekoppeld. DeviceInformationPairing.CanPair is afgeleid van deze eigenschap.
System.Devices.AepContainer.ContainerId GUID Identiteit van dit apparaat. Dit is ook de waarde van DeviceInformation.Id, maar in GUID-vorm.
System.Devices.AepContainer.IsPaired Boolean Geeft aan of een van de onderliggende AssociationEndpoint-apparaten momenteel is gekoppeld. DeviceInformationPairing.IsPaired is afgeleid van deze eigenschap.
System.Devices.AepContainer.IsPresent Boolean Geeft aan of momenteel een van de onderliggende AssociationEndpoint-apparaten aanwezig is, wat betekent dat het apparaat online is en via het netwerk of een draadloos protocol is gedetecteerd. Zodra een apparaat is gekoppeld aan het systeem, wordt het apparaat in de cache opgeslagen. Hierna wordt het apparaat automatisch gedetecteerd bij het uitvoeren van query's op AssociationEndpoint-objecten . Daarom kunt u niet vertrouwen op het detecteren van het apparaat met een query om aan te geven of het momenteel bruikbaar is. Daarom is deze eigenschap belangrijk.
System.Devices.AepContainer.Manufacturer String De fabrikant van het apparaat.
System.Devices.AepContainer.ModelIds string[] Een lijst met model-id's voor het apparaat. Elk model is een GUID in tekenreeksvorm.
System.Devices.AepContainer.ModelName String De modelnaam van het apparaat.
System.Devices.AepContainer.ProtocolIds GUID[] Een lijst met protocol-id's die hebben bijgedragen aan het bouwen van dit AssociationEndpointContainer-object . Houd er rekening mee dat een AssociationEndpointContainer-apparaat wordt gemaakt door alle AssociationEndpoint-apparaten te verzamelen die zijn gedetecteerd via verschillende protocollen voor hetzelfde fysieke apparaat.
System.Devices.AepContainer.SupportedUriSchemes string[] Lijst met cast-URI-schema's die door dit apparaat worden ondersteund.
System.Devices.AepContainer.SupportsAudio Boolean Geeft aan of dit apparaat audiocasting ondersteunt.
System.Devices.AepContainer.SupportsImages Boolean Geeft aan of dit apparaat het casten van afbeeldingen ondersteunt.
System.Devices.AepContainer.SupportsVideo Boolean Geeft aan of dit apparaat videocasting ondersteunt.
System.ItemNameDisplay String De beste weergavenaam voor het apparaat.

 

Eigenschappen van AssociationEndpointService

Name Typ Description
System.Devices.AepService.AepId String De id van het bovenliggende AssociationEndpoint-object.
System.Devices.AepService.ContainerId GUID De identificatie van het bovenliggende AssociationEndpointContainer-object.
System.Devices.AepService.ParentAepIsPaired Boolean Geeft aan of het bovenliggende AssociationEndpoint-object is gekoppeld aan het systeem.
System.Devices.AepService.ProtocolId GUID De identiteit van het protocol dat wordt gebruikt om dit apparaat te detecteren.
System.Devices.AepService.ServiceClassId GUID Identiteit van de service die wordt vertegenwoordigd door dit apparaat.
System.Devices.AepService.ServiceId String Identiteit van deze service. Dit is ook de waarde van DeviceInformation.Id.
System.ItemNameDisplay String De beste weergavenaam voor de dienst.
  • Last updated on