디바이스 정보 속성

  • 아티클

각 장치에는 특정 정보가 필요하거나 장치 선택기를 빌드할 때 사용할 수 있는 DeviceInformation 속성이 연결되어 있습니다. AQS(고급 쿼리 구문) 필터를 사용하여 이러한 속성을 지정하고 지정된 특성으로 열거된 장치를 제한할 수 있습니다. 이러한 속성을 사용하여 각 장치에 대해 반환하려는 정보를 나타낼 수도 있습니다. 이를 통해 애플리케이션에 반환되는 장치 정보를 지정할 수 있습니다.

중요 API

장치 선택기에서 DeviceInformation 속성을 사용하는 방법에 대한 자세한 정보는 장치 선택기 빌드하기를 참조하세요. 이 항목에서는 정보 속성을 요청하는 방법을 보여 줍니다. 몇 가지 일반적인 속성에 대해 설명합니다.

DeviceInformation 개체는 ID(DeviceInformation.Id), 종류(DeviceInformation.Kind) 및 속성 모음(DeviceInformation.Properties)으로 구성됩니다. DeviceInformation 개체의 다른 모든 속성은 Properties 속성 모음에서 파생됩니다. 예를 들어 Name은 System.ItemNameDisplay에서 파생됩니다. 즉, 속성 모음에는 다른 속성을 확인하는 데 필요한 정보가 항상 포함됩니다.

요청 속성

DeviceInformation 개체에는 Id, Kind 등의 몇 가지 기본 속성이 있지만, 대부분의 속성은 Properties 아래의 속성 모음에 저장됩니다. 이 때문에 속성 모음에는 속성 모음에서 속성을 원본으로 지정하는 데 사용되는 속성이 포함됩니다. 예를 들어 System.ItemNameDisplay를 사용하여 Name 속성의 원본을 지정합니다. 이는 사용자에게 친숙한 이름을 가진 일반적이고 잘 알려진 속성의 경우입니다. Windows는 속성을 더 쉽게 쿼리할 수 있도록 이러한 사용자 친화적인 이름 중 몇 가지를 제공합니다.

속성을 요청하는 경우 사용자에게 친숙한 이름을 가진 공통 속성으로 제한되지 않습니다. 기본 GUID 및 PID(속성 ID)를 지정하여 사용 가능한 모든 속성(개별 장치 또는 드라이버에서 제공하는 사용자 지정 속성)을 요청할 수 있습니다. 사용자 지정 속성을 지정하는 형식은 "{GUID} PID"입니다. 예를 들어 “{744e3bed-3684-4e16-9f8a-07953a8bf2ab} 7”입니다.

참고

장치 드라이버의 장치 속성 키 헤더 파일에서 속성 Guid의 목록을 찾을 수 있습니다.

일부 속성은 모든 DeviceInformationKind 개체에서 일반적이지만 대부분은 특정 종류에 고유합니다. 다음의 섹션은 개별 DeviceInformationKind별로 정렬된 몇 가지 일반적인 속성을 나열합니다. 서로 다른 종류가 서로 어떻게 관련되는지에 대한 자세한 정보는 DeviceInformationKind를 참조하세요.

DeviceInterface 속성

DeviceInterface 는 앱 시나리오에서 사용되는 기본 및 가장 일반적인 DeviceInformationKind 개체입니다. 장치 API가 다른 특정 DeviceInformationKind를 나타내지 않는 한 사용해야 하는 개체의 종류입니다.

속성 형식 설명
System.Devices.ContainerId GUID 이 DeviceInterface를 포함하는 Device를 포함하는 DeviceInformationKind.DeviceContainer의 ID입니다. DeviceInformationKind.DeviceContainer와 함께 CreateFromIdAsync에 이 값을 전달하여 적절한 컨테이너를 찾을 수 있습니다.
System.Devices.InterfaceClassGuid GUID 이 인터페이스가 나타내는 인터페이스 클래스 GUID입니다.
System.Devices.DeviceInstanceId 문자열 부모 DeviceInformationKind.Device의 ID입니다. DeviceInformationKind.Device와 함께 CreateFromIdAsync에 이 값을 전달하여 적절한 장치를 찾을 수 있습니다.
System.Devices.InterfaceEnabled Boolean 인터페이스를 사용할 수 있는지 여부를 나타냅니다. DeviceInformation.IsEnabled는 이 속성에서 파생됩니다.
System.Devices.GlyphIcon 문자열 문자 모양에 대한 아이콘 경로입니다.
System.Devices.IsDefault Boolean System.Devices.InterfaceClassGuid의 기본 장치인지 여부를 나타냅니다. 기본적으로 프린터에 사용됩니다. 여러 오디오 기본값이 있으므로 오디오에서는 작동하지 않습니다. GetDefaultAudioRenderId 또는 GetDefaultAudioCaptureId를 사용하여 오디오 기본값을 가져옵니다.
System.Devices.Icon 문자열 아이콘 경로입니다.
System.ItemNameDisplay 문자열 장치 개체에 가장 적합한 표시 이름입니다.

 

장치 속성

속성 형식 설명
System.Devices.ClassGuid GUID 장치 설치 중에 사용되는 장치 클래스입니다. 자세한 정보는 장치 설정 클래스를 참조하세요.
System.Devices.CompatibleIds 문자열[] 장치의 호환 가능한 ID입니다. Windows가 장치에 설치할 최상의 드라이버를 결정할 때 사용됩니다. 자세한 정보는 호환 ID를 참조하세요.
System.Devices.ContainerId GUID 이 장치를 포함하는 DeviceInformationKind.DeviceContainer의 ID입니다. DeviceInformationKind.DeviceContainer와 함께 CreateFromIdAsync에 이 값을 전달하여 적절한 컨테이너를 찾을 수 있습니다.
System.Devices.DeviceCapabilities UInt32 CfgMgr32.h에 정의된 CM_DEVCAP_X 기능 플래그의 비트 OR입니다. 자세한 정보는 DEVPKEY_Device_Capabilities를 참조하세요.
System.Devices.DeviceHasProblem Boolean 현재 장치에 문제가 있으며 제대로 작동하지 않을 수 있습니다. 오래된 드라이버, 누락된 드라이버 또는 잘못된 드라이버 때문일 수 있습니다.
System.Devices.DeviceInstanceId 문자열 장치의 ID입니다. 이는 DeviceInformation.Id의 값이기도 합니다.
System.Devices.DeviceManufacturer 문자열 장치의 제조업체입니다.
System.Devices.HardwareIds 문자열[] 장치의 하드웨어 ID입니다. Windows는 설치하기에 가장 적합한 드라이버를 결정할 때 이러한 ID를 사용합니다. 장치 공급업체는 이 속성을 사용하여 앱에서 장치를 식별할 수 있습니다. 자세한 정보는 하드웨어 ID를 참조하세요.
System.Devices.Parent 문자열 부모 장치의 DeviceInformation.Id입니다. DeviceContainer 부모가 아닌 연결 부모입니다.
System.Devices.Present Boolean 장치가 현재 존재하며 사용 가능한지 여부를 나타냅니다.
System.ItemNameDisplay 문자열 이 장치 개체에 가장 적합한 표시 이름입니다. 이 경우 이는 사용자에게 가장 적합한 이름이 아닙니다. 연결된 DeviceContainer 또는 DeviceInterface의 System.ItemNameDisplay를 참조하면 사용자에게 친숙한 이름을 고를 가능성이 더 높아집니다.

 

DeviceContainer 속성

속성 형식 설명
System.Devices.Category 문자열[] 장치가 속한 범주에 대한 설명 목록입니다. 이 목록은 단수 범주로 제공됩니다. 예를 들어 "Display", "Phone" 또는 "Audio device"입니다.
System.Devices.CategoryIds 문자열[] 이 장치가 속한 범주 목록을 포함합니다. 예를 들어 Audio.Headphone, Display.Monitor 또는 Input.Gaming입니다.
System.Devices.CategoryPlural 문자열[] 장치가 속한 범주에 대한 설명 목록입니다. 이 목록은 복수 범주로 제공됩니다. 예를 들어 "Displays", "Phones" 또는 "Audio devices"입니다.
System.Devices.CompatibleIds 문자열[] 모든 자식 DeviceInformationKind.Device 개체에 대해 호환 가능한 ID의 컬렉션입니다.
System.Devices.Connected Boolean 장치가 현재 시스템에 연결되어 있는지 여부를 나타냅니다.
System.Devices.GlyphIcon 문자열 문자 모양에 대한 아이콘 경로입니다.
System.Devices.HardwareIds 문자열[] 모든 자식 DeviceInformationKind.Device 개체에 대한 하드웨어 ID의 컬렉션입니다.
System.Devices.Icon 문자열 아이콘 경로입니다.
System.Devices.LocalMachine Boolean 이 DeviceContainer가 시스템 자체를 나타내는 경우에는 True이고, 장치가 시스템 외부에 있으면 false입니다.
System.Devices.Manufacturer 문자열 장치의 제조업체입니다.
System.Devices.ModelName 문자열 장치 컨테이너의 모델 이름입니다.
System.Devices.Paired Boolean 자식 DeviceInformationKind.Device 개체가 현재 시스템과 페어링된 무선 또는 네트워크 장치인지 여부를 나타냅니다.
System.ItemNameDisplay 문자열 이 장치에 가장 적합한 표시 이름입니다.

 

DeviceInterfaceClass 속성

속성 형식 설명
System.ItemNameDisplay 문자열 이 장치에 가장 적합한 표시 이름입니다.

 

DevicePanel 속성

속성 형식 설명
System.Devices.Panel.PanelId 문자열 DevicePanel 개체의 식별자입니다.
System.Devices.Panel.PanelGroup 문자열 부모 PanelGroup의 식별자입니다.

AssociationEndpoint 속성

속성 형식 설명
System.Devices.Aep.AepId 문자열 이 장치의 ID입니다. 이는 DeviceInformation.Id의 값이기도 합니다.
System.Devices.Aep.CanPair Boolean 장치를 시스템과 페어링할 수 있는지 여부를 나타냅니다. DeviceInformationPairing.CanPair는 이 속성에서 파생됩니다.
System.Devices.Aep.Category 문자열[] 장치가 속한 범주입니다. 예를 들어 프린터 또는 카메라입니다.
System.Devices.Aep.ContainerId GUID 부모 AssociationEndpointContainer 개체의 ID입니다.
System.Devices.Aep.DeviceAddress 문자열 장치의 주소입니다. 장치가 네트워크 장치인 경우의 IP 주소입니다.
System.Devices.Aep.IsConnected Boolean 장치가 현재 시스템에 연결되어 있는지를 나타냅니다.
System.Devices.Aep.IsPaired Boolean 장치가 현재 페어링되어 있는지를 나타냅니다. DeviceInformationPairing.IsPaired는 이 속성에서 파생됩니다.
System.Devices.Aep.IsPresent Boolean 장치가 현재 존재하는지 여부를 나타냅니다. 즉, 장치가 네트워크 또는 무선 프로토콜을 통해 실시간으로 검색됩니다. 장치가 시스템과 페어링되면 장치가 캐시됩니다. 그런 다음 AssociationEndpoint 개체를 쿼리할 때 장치가 자동으로 검색됩니다. 따라서 쿼리를 사용하여 장치를 검색하여 현재 사용할 수 있는지 여부를 나타낼 수 없습니다. 이 속성이 중요한 이유입니다.
System.Devices.Aep.Manufacturer 문자열 장치의 제조업체입니다.
System.Devices.Aep.ModelId GUID 장치의 모델 ID입니다.
System.Devices.Aep.ModelName 문자열 장치의 모델 이름입니다.
System.Devices.Aep.ProtocolId GUID 이 AssocationEndpoint 장치를 검색하는 데 사용되는 프로토콜을 나타냅니다.
System.Devices.Aep.SignalStrength Int32 장치의 신호 강도입니다. 이 속성은 일부 프로토콜에만 적용할 수 있습니다.
System.ItemNameDisplay 문자열 장치에 가장 적합한 표시 이름입니다.

 

AssociationEndpointContainer 속성

속성 형식 설명
System.Devices.AepContainer.Categories 문자열[] 장치가 속한 범주입니다. 예를 들어 프린터 또는 카메라입니다.
System.Devices.AepContainer.Children 문자열[] 이 컨테이너의 일부인 AssocationEndpoint 개체에 대한 ID 컬렉션입니다.
System.Devices.AepContainer.CanPair Boolean 자식 AssociationEndpoint 장치 중 하나를 시스템과 페어링할 수 있는지 여부를 나타냅니다. DeviceInformationPairing.CanPair는 이 속성에서 파생됩니다.
System.Devices.AepContainer.ContainerId GUID 이 장치의 ID입니다. 이 값은 DeviceInformation.Id의 값이기도 하지만 GUID 형식입니다.
System.Devices.AepContainer.IsPaired Boolean 자식 AssociationEndpoint 장치 중 하나가 현재 페어링되어 있는지를 나타냅니다. DeviceInformationPairing.IsPaired는 이 속성에서 파생됩니다.
System.Devices.AepContainer.IsPresent Boolean 자식 AssociationEndpoint 장치 중 하나가 현재 존재하는지 여부를 나타냅니다. 즉, 네트워크 또는 무선 프로토콜을 통해 실시간으로 장치를 검색합니다. 장치가 시스템과 페어링되면 장치가 캐시됩니다. 그런 다음 AssociationEndpoint 개체를 쿼리할 때 장치가 자동으로 검색됩니다. 따라서 쿼리를 사용하여 장치를 검색하여 현재 사용할 수 있는지 여부를 나타낼 수 없습니다. 이 속성이 중요한 이유입니다.
System.Devices.AepContainer.Manufacturer 문자열 장치의 제조업체입니다.
System.Devices.AepContainer.ModelIds 문자열[] 장치의 모델 ID 목록입니다. 각 모델은 문자열 형식의 GUID입니다.
System.Devices.AepContainer.ModelName 문자열 장치의 모델 이름입니다.
System.Devices.AepContainer.ProtocolIds GUID[] 이 AssociationEndpointContainer 개체를 빌드하는 데 기여한 프로토콜 ID 목록입니다. AssociationEndpointContainer 장치는 동일한 물리적 장치에 대해 서로 다른 프로토콜을 통해 검색된 모든 AssociationEndpoint장치를 수집하여 만들어집니다.
System.Devices.AepContainer.SupportedUriSchemes 문자열[] 이 장치에서 지원하는 캐스팅 URI 체계 목록입니다.
System.Devices.AepContainer.SupportsAudio Boolean 이 장치가 오디오 캐스팅을 지원하는지 여부를 나타냅니다.
System.Devices.AepContainer.SupportsImages Boolean 이 장치가 이미지 캐스팅을 지원하는지 여부를 나타냅니다.
System.Devices.AepContainer.SupportsVideo Boolean 이 장치가 비디오 캐스팅을 지원하는지 여부를 나타냅니다.
System.ItemNameDisplay 문자열 장치에 가장 적합한 표시 이름입니다.

 

AssociationEndpointService 속성

속성 형식 설명
System.Devices.AepService.AepId 문자열 부모 AssociationEndpoint 개체의 식별자입니다.
System.Devices.AepService.ContainerId GUID 부모 AssociationEndpointContainer 개체의 식별자입니다.
System.Devices.AepService.ParentAepIsPaired Boolean 부모 AssociationEndpoint 개체가 시스템과 페어링되는지 여부를 나타냅니다.
System.Devices.AepService.ProtocolId GUID 이 장치를 검색하는 데 사용되는 프로토콜의 ID입니다.
System.Devices.AepService.ServiceClassId GUID 이 장치가 나타내는 서비스의 아이덴티티입니다.
System.Devices.AepService.ServiceId 문자열 이 서비스 ID입니다. 이는 DeviceInformation.Id의 값이기도 합니다.
System.ItemNameDisplay 문자열 서비스에 가장 적합한 표시 이름입니다.