장치 선택기 빌드하기

  • 아티클

장치 선택기를 사용하면 장치를 열거할 때 검색하도록 장치를 제한할 수 있으므로 더 관련성이 높고 시스템 성능을 향상시킬 수 있습니다.

대부분의 시나리오에서 장치 스택에서 장치 선택기를 가져옵니다. 예를 들어 USB를 통해 검색된 디바이스에 GetDeviceSelector를 사용할 수 있습니다. 이러한 장치 선택기는 고급 쿼리 구문(AQS) 문자열을 반환합니다. AQS 형식에 대해 자세히 알아보려면 프로그래밍 방식으로 고급 쿼리 구문 사용하기를 참조하세요.

중요 API

필터 문자열 빌드하기

장치를 열거해야 하는 경우가 있으며 제공된 장치 선택기를 시나리오에 사용할 수 없는 경우도 있습니다. 장치 선택기는 AQS 필터 문자열로 다음의 정보를 포함합니다. 필터 문자열을 만들기 전에 열거하려는 장치에 대한 몇 가지 주요 정보를 알아야 합니다.

  • 관심 있는 장치의 DeviceInformationKind입니다. DeviceInformationKind가 열거형 장치에 미치는 영향에 대한 자세한 정보는 장치 열거하기를 참조하세요.
  • AQS 필터 문자열을 빌드하는 방법(이 항목에서 설명됨)입니다.
  • 관심 있는 속성입니다. DeviceInformationKind에에 따라 사용 가능한 속성이 달라집니다. 자세한 내용을 보려면 장치 ID 속성을 참조하세요.
  • 쿼리하는 프로토콜입니다. 무선 또는 유선 네트워크를 통해 장치를 검색하는 경우에만 필요합니다. 이 작업을 수행하는 방법에 대한 자세한 정보는 네트워크를 통해 디바이스 열거하기를 참조하세요.

Windows.Devices.Enumeration API를 사용하는 경우, 장치 선택기를 관심 있는 장치 종류와 자주 결합합니다. 사용 가능한 장치 종류의 목록은 DeviceInformationKind 열거에 의해 정의됩니다. 이러한 요인의 조합은 관심 있는 장치에서 사용할 수 있는 장치를 제한하는 데 도움이 됩니다. DeviceInformationKind를 지정하지 않거나 사용 중인 메서드가 DeviceInformationKind 매개 변수를 제공하지 않는 경우, 기본 종류는 DeviceInterface입니다.

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_LESSTHANOREQUAL UInt16, UInt32
COP_GREATERTHANOREQUAL UInt16, UInt32
COP_VALUE_CONTAINS 문자열, 문자열 배열, boolean 배열, GUID 배열, UInt16 배열, UInt32 배열
COP_VALUE_NOTCONTAINS 문자열, 문자열 배열, boolean 배열, GUID 배열, UInt16 배열, UInt32 배열
COP_VALUE_STARTSWITH 문자열
COP_VALUE_ENDSWITH 문자열
COP_DOSWILDCARDS 지원되지 않음
COP_WORD_EQUAL 지원되지 않음
COP_WORD_STARTSWITH 지원되지 않음
COP_APPLICATION_SPECIFIC 지원되지 않음

COP_EQUAL 또는 COP_NOTEQUAL에 대해 NULL을 지정할 수 있습니다. 값이 없거나 값이 없는 속성으로 변환됩니다. AQS에서는 빈 대괄호[]를 사용하여 NULL을 지정합니다.

중요

COP_VALUE_CONTAINS 연산자와 COP_VALUE_NOTCONTAINS 연산자를 사용할 때는 문자열 및 문자열 배열에서 다르게 동작합니다. 문자열의 경우 시스템은 대/소문자를 구분하지 않는 검색을 수행하여 장치에 표시된 문자열을 부분 문자열로 포함하는지 여부를 확인합니다. 문자열 배열의 경우 부분 문자열은 검색되지 않습니다. 문자열 배열을 사용하면 배열이 검색되어 지정된 전체 문자열이 포함되어 있는지 여부를 확인합니다. 문자열 배열을 검색하여 배열의 요소에 부분 문자열이 포함되어 있는지 여부를 확인할 수 없습니다.

결과의 범위를 적절하게 지정하는 단일 AQS 필터 문자열을 만들 수 없는 경우 결과를 받은 후 필터링할 수 있습니다. 그러나 Windows.Devices.Enumeration API에 제공할 때는 초기 AQS 필터 문자열의 결과를 최대한 제한하는 것이 좋습니다. 이렇게 하면 애플리케이션의 성능을 향상시키는 데 도움이 됩니다.

AQS 문자열 예시

다음의 예시는 열거하려는 장치를 AQS 구문을 사용하여 제한하는 방법을 보여 줍니다. 이러한 모든 필터 문자열은 DeviceInformationKind와 페어링되어 전체 필터를 만듭니다. 지정된 종류가 없는 경우 기본 종류는 DeviceInterface임을 기억하세요.

이 필터가 DeviceInterface의 DeviceInformationKind와 쌍을 이루면, 오디오 캡처 인터페이스 클래스를 포함하고 현재 사용하도록 설정된 모든 개체를 열거합니다. =은 COP_EQUALS로 변환됩니다.

System.Devices.InterfaceClassGuid:="{2eef81be-33fa-4800-9670-1cd474972c3f}" AND
System.Devices.InterfaceEnabled:=System.StructuredQueryType.Boolean#True

이 필터가 Device의 DeviceInformationKind와 쌍을 이루면, 하나 이상의 하드웨어 ID가 GenCdRom인 모든 개체를 열거합니다. ~~는 COP_VALUE_CONTAINS로 변환됩니다.

System.Devices.HardwareIds:~~"GenCdRom"

이 필터가 DeviceContainer의 DeviceInformationKind와 쌍을 이룰 때, 이 필터는 하위 문자열 Microsoft가 포함된 모델 이름이 있는 모든 개체를 열거합니다. ~~는 COP_VALUE_CONTAINS로 변환됩니다.

System.Devices.ModelName:~~"Microsoft"

이 필터가 DeviceInterface의 DeviceInformationKind와 쌍을 이룰 때, 이 필터는 이름이 하위 문자열 Microsoft로 시작하는 모든 개체를 열거합니다. ~<은(는) COP_STARTSWITH로 변환됩니다.

System.ItemNameDisplay:~<"Microsoft"

이 필터가 Device의 DeviceInformationKind와 쌍을 이룰 때, 이 필터는 System.Devices.IpAddress 속성이 설정된 모든 개체를 열거합니다. <>[]은(는) NULL 값과 결합된 COP_NOTEQUALS로 변환됩니다.

System.Devices.IpAddress:<>[]

이 필터가 Device의 DeviceInformationKind와 쌍을 이룰 때, 이 필터는 System.Devices.IpAddress 속성이 설정되지 않은 모든 개체를 열거합니다. =[]은(는) NULL 값과 결합된 COP_EQUALS로 변환됩니다.

System.Devices.IpAddress:=[]

관련 항목