디바이스 선택기를 사용하면 디바이스를 열거할 때 검색하도록 디바이스를 제한할 수 있으므로 더 관련성이 높고 시스템 성능을 향상시킬 수 있습니다.
대부분의 시나리오에서는 디바이스 스택에서 디바이스 선택기를 가져옵니다. 예를 들어 USB를 통해 검색된 디바이스에 GetDeviceSelector 사용할 수 있습니다. 이러한 디바이스 선택기는 AQS(고급 쿼리 구문) 문자열을 반환합니다. AQS 형식에 대한 자세한 내용은 프로그래밍 방식으로 고급 쿼리 구문 사용을 참조하세요.
주요 API들
필터 문자열 빌드
디바이스를 열거해야 하는 경우가 있으며 제공된 디바이스 선택기를 시나리오에 사용할 수 없는 경우도 있습니다. 디바이스 선택기는 다음 정보를 포함하는 AQS 필터 문자열입니다. 필터 문자열을 만들기 전에 열거하려는 디바이스에 대한 몇 가지 주요 정보를 알아야 합니다.
- 관심 있는 디바이스의 DeviceInformationKind. DeviceInformationKind가 디바이스 열거에 미치는 영향에 대한 자세한 내용은 디바이스 열거를 참조하세요.
- AQS 필터 문자열을 빌드하는 방법(이 항목에서 설명).
- 관심 있는 속성들입니다. 사용 가능한 속성은 DeviceInformationKind에 따라 달라집니다. 자세한 내용은 디바이스 정보 속성 참조하세요.
- 당신이 쿼리하는 프로토콜입니다. 무선 또는 유선 네트워크를 통해 디바이스를 검색하는 경우에만 필요합니다. 이 작업을 수행하는 방법에 대한 자세한 내용은 네트워크통해 디바이스 열거를 참조하세요.
Windows.Devices.Enumeration API를 사용하는 경우 디바이스 선택기를 관심 있는 디바이스 종류와 자주 결합합니다. 사용 가능한 디바이스 종류 목록은 DeviceInformationKind 열거형으로 정의됩니다. 이러한 요인의 조합은 사용자가 관심 있는 디바이스만 사용할 수 있도록 제한하는 데 도움이 됩니다. DeviceInformationKind
Windows.Devices.Enumeration API는 정식 AQS 구문을 사용하지만 모든 연산자가 지원되지는 않습니다. 필터 문자열을 생성할 때 사용할 수 있는 속성 목록은
주의
{GUID} PID 형식을 사용하여 정의된 사용자 지정 속성은 AQS 필터 문자열을 생성할 때 사용할 수 없습니다. 속성 형식이 잘 알려진 속성 이름에서 파생되기 때문입니다.
다음 표에서는 AQS 연산자와 지원하는 매개 변수 형식을 나열합니다.
| 오퍼레이터 | 지원되는 형식 |
|---|---|
| COP_EQUAL | String, Boolean, GUID, UInt16, UInt32 |
| COP_NOTEQUAL | String, Boolean, GUID, UInt16, UInt32 |
| COP_LESSTHAN | UInt16, UInt32 |
| COP_GREATERTHAN | UInt16, UInt32 |
| COP_작거나같음 | UInt16, UInt32 |
| COP_GREATERTHANOREQUAL | UInt16, UInt32 |
| COP_값_포함 | 문자열, 문자열 배열, 부울 배열, GUID 배열, UInt16 배열, UInt32 배열 |
| COP_VALUE_NOTCONTAINS | 문자열, 문자열 배열, 부울 배열, GUID 배열, UInt16 배열, UInt32 배열 |
| COP_VALUE_STARTSWITH | 문자열 |
| COP_VALUE_ENDSWITH | 문자열 |
| COP_DOSWILDCARDS | 지원되지 않음 |
| COP_WORD_EQUAL | 지원되지 않음 |
| COP_WORD_STARTSWITH | 지원되지 않음 |
| COP_응용_특정 | 지원되지 않음 |
NULL을 COP_EQUAL 또는 COP_NOTEQUAL로 지정할 수 있습니다. 값이 없는 속성 또는 값이 존재하지 않는 속성을 의미합니다. AQS에서는 빈 대괄호 []를 사용하여 NULL 지정합니다.
중요합니다
COP_VALUE_CONTAINS 및 COP_VALUE_NOTCONTAINS 연산자를 사용하는 경우 문자열 및 문자열 배열과 다르게 동작합니다. 문자열의 경우 시스템은 대/소문자를 구분하지 않는 검색을 수행하여 디바이스에 표시된 문자열을 부분 문자열로 포함하는지 확인합니다. 문자열 배열의 경우 부분 문자열은 검색되지 않습니다. 문자열 배열을 사용하면 배열이 검색되어 지정된 전체 문자열이 포함되어 있는지 확인합니다. 문자열 배열을 검색하여 배열의 요소에 부분 문자열이 포함되어 있는지 확인할 수 없습니다.
결과의 범위를 적절하게 지정하는 단일 AQS 필터 문자열을 만들 수 없는 경우 결과를 받은 후 필터링할 수 있습니다. 그러나 초기 AQS 필터 문자열의 결과를 Windows.Devices.Enumeration API에 제공할 때 가능한 한 제한하는 것이 좋습니다. 이렇게 하면 애플리케이션의 성능을 향상시키는 데 도움이 됩니다.
AQS 문자열 예제
다음 예제에서는 AQS 구문을 사용하여 열거하려는 디바이스를 제한하는 방법을 보여 줍니다. 이러한 모든 필터 문자열은 DeviceInformationKind와 함께 결합되어 전체 필터를 만듭니다. 종류가 지정되지 않은 경우, 기본 종류는 DeviceInterface입니다.
이 필터가 DeviceInformationKind 쌍과 함께 DeviceInterface와 결합될 때, 오디오 캡처 인터페이스 클래스를 포함하고 현재 사용하도록 설정된 모든 개체를 열거합니다. =는 과(는)와 같다.
System.Devices.InterfaceClassGuid:="{2eef81be-33fa-4800-9670-1cd474972c3f}" AND
System.Devices.InterfaceEnabled:=System.StructuredQueryType.Boolean#True
이 필터가 Device및 DeviceInformationKind와 결합될 때, GenCdRom이라는 하드웨어 ID를 가진 모든 개체를 열거합니다. ~~은(는) 을(를)으로(로) 해석합니다.
System.Devices.HardwareIds:~~"GenCdRom"
이 필터가 DeviceContainerDeviceInformationKind 쌍을 이루면 부분 문자열 Microsoft가 포함된 모델 이름이 있는 모든 개체를 열거합니다. ~~은(는) 을(를)으로(로) 해석합니다.
System.Devices.ModelName:~~"Microsoft"
이 필터가 DeviceInformationKind 및 DeviceInterface와 쌍을 이루면, 이름이 'Microsoft'로 시작하는 모든 개체를 열거합니다. ~<는 COP_STARTSWITH로 변환됩니다.
System.ItemNameDisplay:~<"Microsoft"
이 필터가 Device및 DeviceInformationKind와 결합될 때, System.Devices.IpAddress 속성이 설정된 모든 객체를 나열합니다. <>[]는 COP_NOTEQUALS가 NULL 값과 결합된 것으로 변환됩니다.
System.Devices.IpAddress:<>[]
이 필터가 DeviceInformationKind와 Device를 쌍으로 이루는 경우, System.Devices.IpAddress 속성이 설정되지 않은 모든 개체를 열거합니다. =[]은 COP_EQUALS와 NULL 값과 결합됩니다.
System.Devices.IpAddress:=[]