Egenskaper för enhetsinformation

Varje enhet har associerade egenskaper Enhetsinformation som du kan använda när du behöver specifik information eller när du skapar en enhetsväljare. Ett AQS-filter (Advanced Query Syntax) kan användas för att ange dessa egenskaper och begränsa de uppräknade enheterna med de angivna egenskaperna. Du kan också använda de här egenskaperna för att ange vilken information du vill returnera för varje enhet. Det gör att du kan ange enhetsinformationen som returneras till ditt program.

Mer information om hur du använder egenskaperna DeviceInformation i enhetsväljaren finns i Build a device selector. Det här avsnittet visar hur du begär informationsegenskaper och beskriver några vanliga egenskaper.

Objektet DeviceInformation består av en identitet (DeviceInformation.Id), en typ (DeviceInformation.Kind) och en egenskapsväska (DeviceInformation.Properties). Alla andra egenskaper för ett DeviceInformation-objekt härleds från egenskapsväskan Egenskaper . Namn härleds till exempel från System.ItemNameDisplay. Det innebär att property bag alltid innehåller den information som krävs för att avgöra de andra egenskaperna.

Begära egenskaper

Ett DeviceInformation-objekt har vissa grundläggande egenskaper. till exempel Id och Kind, men de flesta egenskaperna lagras i en egenskapsväska under Egenskaper. Därför innehåller egenskapspåsen de egenskaper som används för att hämta ut egenskaperna ur egenskapspåsen. Använd till exempel System.ItemNameDisplay för att hämta egenskapen Namn . Detta gäller en vanlig och välkänd egenskap som har ett användarvänligt namn. Windows innehåller flera av dessa användarvänliga namn för att göra det enklare att fråga efter egenskaper.

När du begär egenskaper är du inte begränsad till vanliga egenskaper med användarvänliga namn. Du kan ange underliggande GUID och egenskaps-ID (PID) för att begära alla tillgängliga egenskaper, även anpassade egenskaper som tillhandahålls av en enskild enhet eller drivrutin. Formatet för att ange en anpassad egenskap är "{GUID} PID". Till exempel: "{744e3bed-3684-4e16-9f8a-07953a8bf2ab} 7".

Note

Du hittar listan över egenskaps-GUID:er i enhetsegenskapens huvudfil för enhetsdrivrutinen.

Vissa egenskaper är vanliga för alla DeviceInformationKind-objekt , men de flesta är unika för en viss typ. I följande avsnitt visas några vanliga egenskaper sorterade efter den enskilda DeviceInformationKind. Mer information om hur de olika typerna relaterar till varandra finns i DeviceInformationKind.

DeviceInterface-egenskaper

DeviceInterface är standardobjektet och det vanligaste DeviceInformationKind-objektet som används i appscenarier. Det här är den typ av objekt som du bör använda om inte enhets-API:et anger en annan specifik DeviceInformationKind.

Namn Type Description
System.Devices.ContainerId GUID Identitet för den DeviceInformationKind.DeviceContainer som innehåller den Device som innehåller detta DeviceInterface. Du kan skicka det här värdet till CreateFromIdAsync tillsammans med DeviceInformationKind.DeviceContainer för att hitta rätt container.
System.Devices.InterfaceClassGuid GUID Gränssnittsklassens GUID som det här gränssnittet representerar.
System.Devices.DeviceInstanceId String Identitet för den överordnade DeviceInformationKind.Device. Du kan skicka det här värdet till CreateFromIdAsync tillsammans med DeviceInformationKind.Device för att hitta rätt enhet.
System.Devices.InterfaceEnabled Boolean Anger om gränssnittet är aktiverat. DeviceInformation.IsEnabled härleds från den här egenskapen.
System.Devices.GlyphIcon String Sökväg till ikonen för glyfen.
System.Devices.IsDefault Boolean Anger om detta är standardenheten för System.Devices.InterfaceClassGuid. Detta används främst för skrivare. Detta fungerar inte för ljud eftersom det finns flera ljudstandarder. Använd GetDefaultAudioRenderId eller GetDefaultAudioCaptureId för att hämta ljudstandarder.
System.Devices.Icon String Sökväg till ikon.
System.ItemNameDisplay String Det bästa visningsnamnet för enhetsobjektet.

 

Enhetsegenskaper

Namn Type Description
System.Devices.ClassGuid GUID Enhetsklass som används under enhetsinstallationen. Mer information finns i Enhetsinstallationsklasser.
System.Devices.CompatibleIds Sträng[] Enhetens kompatibla ID:n. Dessa används när Windows fastställer den bästa drivrutinen som ska installeras på enheten. Mer information finns i Kompatibelt ID.
System.Devices.ContainerId GUID Identitet för DeviceInformationKind.DeviceContainer som innehåller den här enheten. Du kan skicka det här värdet till CreateFromIdAsync tillsammans med DeviceInformationKind.DeviceContainer för att hitta rätt container.
System.Devices.DeviceCapabilities UInt32 En bitvis OR-kombination av kapabilitetsflaggorna CM_DEVCAP_X som definieras i CfgMgr32.h. Mer information finns i DEVPKEY_Device_Capabilities.
System.Devices.DeviceHasProblem Boolean Enheten har för närvarande ett problem och fungerar troligen inte korrekt. Detta kan bero på en inaktuell, saknad eller ogiltig drivrutin.
System.Devices.DeviceInstanceId String Enhetens identitet. Det här är också värdet för DeviceInformation.Id.
System.Devices.DeviceManufacturer String Enhetens tillverkare.
System.Devices.HardwareIds Sträng[] Enhetens maskinvaru-ID:n. Windows använder dessa ID:er när du fastställer den bästa drivrutinen som ska installeras. Enhetsleverantörer kan använda den här egenskapen för att identifiera sina enheter från sin app. Mer information finns i Maskinvaru-ID.
System.Devices.Parent String DeviceInformation.Id för den överordnade enheten. Det här är anslutningens överordnade, inte DeviceContainer:s överordnade.
System.Devices.Present Boolean Anger om enheten för närvarande finns och är tillgänglig.
System.ItemNameDisplay String Det bästa visningsnamnet för det här enhetsobjektet. I det här fallet är detta inte nödvändigtvis det bästa namnet för användare. En mer sannolik kandidat för ett användarvänligt namn kan hittas genom att referera till System.ItemNameDisplay för den associerade DeviceContainer eller DeviceInterface.

 

Egenskaper för DeviceContainer

Namn Type Description
System.Devices.Category Sträng[] En lista med beskrivningar av de kategorier som enheten tillhör. Den här listan tillhandahålls som enstaka kategorier. Till exempel "Display", "Phone" eller "Audio device".
System.Devices.CategoryIds Sträng[] Innehåller en lista över kategorier som den här enheten tillhör. Till exempel Audio.Headphone, Display.Monitor eller Input.Gaming.
System.Devices.CategoryPlural Sträng[] En lista med beskrivningar av de kategorier som enheten tillhör. Den här listan anges i form av pluralkategorier. Till exempel "Visar", "Telefoner" eller "Ljudenheter".
System.Devices.CompatibleIds Sträng[] Samlingen av kompatibla ID:n för alla underordnade objekt av typen DeviceInformationKind.Device.
System.Devices.Connected Boolean Anger om enheten för närvarande är ansluten till systemet eller inte.
System.Devices.GlyphIcon String Sökväg till ikonen för glyfen.
System.Devices.HardwareIds Sträng[] Insamling av maskinvaru-ID:n för alla underordnade DeviceInformationKind.Device-objekt .
System.Devices.Icon String Sökväg till ikon.
System.Devices.LocalMachine Boolean Sant om den här DeviceContainer representerar själva systemet, falskt om enheten är extern mot systemet.
System.Devices.Manufacturer String Enhetens tillverkare.
System.Devices.ModelName String Enhetscontainerns modellnamn.
System.Devices.Paired Boolean Anger om något av de underordnade DeviceInformationKind.Device-objekten är trådlösa eller nätverksenheter som för närvarande är kopplade till systemet.
System.ItemNameDisplay String Det bästa visningsnamnet för den här enheten.

 

DeviceInterfaceClass-egenskaper

Namn Type Description
System.ItemNameDisplay String Det bästa visningsnamnet för den här enheten.

 

DevicePanel-egenskaper

Namn Type Description
System.Devices.Panel.PanelId String Identifieraren för DevicePanel-objektet .
System.Devices.Panel.PanelGroup String Identifieraren för den överordnade panelgruppen.

Egenskaper för AssociationEndpoint

Namn Type Description
System.Devices.Aep.AepId String Enhetens identitet. Det här är också värdet för DeviceInformation.Id.
System.Devices.Aep.CanPair Boolean Anger om enheten kan kopplas till systemet eller inte. DeviceInformationPairing.CanPair härleds från den här egenskapen.
System.Devices.Aep.Category Sträng[] De kategorier som enheten ingår i. Till exempel skrivare eller kamera.
System.Devices.Aep.ContainerId GUID ID:t för det överordnade objektet AssociationEndpointContainer.
System.Devices.Aep.DeviceAddress String Enhetens adress. Om enheten är en nätverksenhet är detta IP-adressen.
System.Devices.Aep.IsConnected Boolean Anger om enheten för närvarande är ansluten till systemet.
System.Devices.Aep.IsPaired Boolean Anger om enheten för närvarande är parkopplad. DeviceInformationPairing.IsPaired härleds från den här egenskapen.
System.Devices.Aep.IsPresent Boolean Anger om enheten för närvarande finns, vilket innebär att enheten är live och identifieras via nätverket eller det trådlösa protokollet. När en enhet har kopplats ihop med systemet cachelagras enheten. Därefter identifieras enheten automatiskt när du frågar efter AssociationEndpoint-objekt . På grund av detta kan du inte förlita dig på att bara identifiera enheten med en fråga för att ange om den för närvarande kan användas. Det är därför den här egenskapen är viktig.
System.Devices.Aep.Manufacturer String Enhetens tillverkare.
System.Devices.Aep.ModelId GUID Enhetens modell-ID.
System.Devices.Aep.ModelName String Enhetens modellnamn.
System.Devices.Aep.ProtocolId GUID Anger det protokoll som används för att identifiera den här AssocationEndpoint-enheten .
System.Devices.Aep.SignalStrength Int32 Enhetens signalstyrka. Den här egenskapen gäller endast för vissa protokoll.
System.ItemNameDisplay String Enhetens bästa visningsnamn.

 

AssociationEndpointContainer-egenskaper

Namn Type Description
System.Devices.AepContainer.Categories Sträng[] De kategorier som enheten ingår i. Till exempel skrivare eller kamera.
System.Devices.AepContainer.Children Sträng[] Samlingen med ID:er för AssocationEndpoint-objekt som ingår i den här containern.
System.Devices.AepContainer.CanPair Boolean Anger om någon av de underordnade AssociationEndpoint-enheterna kan kopplas till systemet eller inte. DeviceInformationPairing.CanPair härleds från den här egenskapen.
System.Devices.AepContainer.ContainerId GUID Enhetens identitet. Det här är också värdet för DeviceInformation.Id, men i GUID-form.
System.Devices.AepContainer.IsPaired Boolean Anger om någon av de underliggande AssociationEndpoint-enheterna för närvarande är parkopplade. DeviceInformationPairing.IsPaired härleds från den här egenskapen.
System.Devices.AepContainer.IsPresent Boolean Anger om någon av de underordnade AssociationEndpoint-enheterna för närvarande finns, vilket innebär att enheten är live och identifieras via nätverket eller det trådlösa protokollet. När en enhet har kopplats ihop med systemet cachelagras enheten. Därefter identifieras enheten automatiskt när du frågar efter AssociationEndpoint-objekt . På grund av detta kan du inte förlita dig på att bara identifiera enheten med en fråga för att ange om den för närvarande kan användas. Det är därför den här egenskapen är viktig.
System.Devices.AepContainer.Manufacturer String Enhetens tillverkare.
System.Devices.AepContainer.ModelIds Sträng[] En lista över modell-ID:n för enheten. Varje modell är ett GUID i strängform.
System.Devices.AepContainer.ModelName String Enhetens modellnamn.
System.Devices.AepContainer.ProtocolIds GUID[] En lista över protokoll-ID:er som har bidragit till att skapa det här AssociationEndpointContainer-objektet . Tänk på att en AssociationEndpointContainer-enhet skapas genom att samla in alla AssociationEndpoint-enheter som identifierats via olika protokoll för samma fysiska enhet.
System.Devices.AepContainer.SupportedUriSchemes Sträng[] Lista över URI-autentiseringsscheman som stöds av den här enheten.
System.Devices.AepContainer.SupportsAudio Boolean Anger om den här enheten stöder ljudgjutning.
System.Devices.AepContainer.SupportsImages Boolean Anger om den här enheten stöder bildgjutning.
System.Devices.AepContainer.SupportsVideo Boolean Anger om den här enheten stöder videogjutning.
System.ItemNameDisplay String Enhetens bästa visningsnamn.

 

Egenskaper för AssociationEndpointService

Namn Type Description
System.Devices.AepService.AepId String Identifieraren för det överordnade AssociationEndpoint-objektet .
System.Devices.AepService.ContainerId GUID Identifieraren för det överordnade AssociationEndpointContainer-objektet .
System.Devices.AepService.ParentAepIsPaired Boolean Anger om det överordnade AssociationEndpoint-objektet är kopplat till systemet.
System.Devices.AepService.ProtocolId GUID Identiteten för det protokoll som används för att identifiera den här enheten.
System.Devices.AepService.ServiceClassId GUID Identitet för tjänsten som representeras av den här enheten.
System.Devices.AepService.ServiceId String Identitet för den här tjänsten. Det här är också värdet för DeviceInformation.Id.
System.ItemNameDisplay String Det bästa visningsnamnet för tjänsten.
  • Last updated on