USB 인터페이스 작업

  • 아티클

프레임워크는 각 USB 인터페이스를 프레임워크 USB 인터페이스 개체로 나타냅니다. 드라이버가 프레임워크 USB 디바이스 개체를 만들 때 프레임워크는 디바이스의 첫 번째 USB 구성에 포함된 각 USB 인터페이스에 대한 프레임워크 USB 인터페이스 개체를 만듭니다.

대부분의 USB 디바이스에는 하나의 인터페이스만 있고 인터페이스에는 하나의 대체 설정만 있습니다. 이러한 디바이스의 드라이버는 일반적으로 프레임워크의 USB 인터페이스 개체가 정의하는 개체 메서드를 사용할 필요가 없습니다.

드라이버가 여러 인터페이스 또는 대체 설정을 제공하는 USB 디바이스를 지원하는 경우 인터페이스 개체 메서드를 사용하면 드라이버가 다음 작업을 수행할 수 있습니다.

인터페이스 정보 가져오기

드라이버가 WdfUsbTargetDeviceCreateWithParameters를 호출한 후 WdfUsbTargetDeviceGetInterface 를 호출하여 디바이스의 USB 인터페이스 중 하나를 나타내는 프레임워크 USB 인터페이스 개체에 대한 핸들을 가져올 수 있습니다. 그런 다음 드라이버는 USB 인터페이스 개체가 USB 인터페이스에 대한 정보를 얻기 위해 정의하는 여러 메서드를 호출할 수 있습니다.

드라이버는 WdfUsbTargetDeviceCreateWithParameters를 호출한 후 언제든지 다음 메서드를 호출할 수 있습니다.

WdfUsbInterfaceGetInterfaceNumber
USB 인터페이스 개체와 연결된 USB 인터페이스 번호를 반환합니다.

WdfUsbInterfaceGetDescriptor
USB 인터페이스의 대체 설정 중 하나와 연결된 USB 인터페이스 설명자를 검색합니다.

WdfUsbInterfaceGetNumEndpoints
USB 인터페이스의 대체 설정 중 하나와 연결된 엔드포인트 수를 반환합니다.

WdfUsbInterfaceGetEndpointInformation
엔드포인트 및 연결된 파이프에 대한 정보를 검색합니다.

드라이버가 WdfUsbTargetDeviceSelectConfig를 호출한 후 다음 메서드를 호출할 수 있습니다.

WdfUsbInterfaceGetConfiguredSettingIndex
현재 USB 인터페이스에 대해 선택된 대체 설정을 식별하는 인덱스 값을 반환합니다.

WdfUsbInterfaceGetNumConfiguredPipes
지정된 USB 디바이스 인터페이스에 대해 구성된 파이프 수를 반환합니다.

WdfUsbInterfaceGetConfiguredPipe
지정된 USB 디바이스 인터페이스 및 파이프 인덱스와 연결된 프레임워크 파이프 개체에 대한 핸들을 반환합니다.

USB 인터페이스에 대한 대체 설정 선택

드라이버가 WdfUsbTargetDeviceCreateWithParameters를 호출한 후 드라이버는 WdfUsbInterfaceGetNumSettings 를 호출하여 USB 인터페이스에서 지원하는 대체 설정 수를 가져올 수 있습니다.

드라이버가 WdfUsbTargetDeviceSelectConfig 를 호출하여 USB 디바이스에 대한 구성을 선택한 후 드라이버는 WdfUsbInterfaceSelectSetting을 호출하여 구성의 USB 인터페이스 중 하나에 대한 대체 설정을 선택할 수 있습니다.

디바이스의 대체 설정은 0부터 연속적으로 번호가 매겨져야 합니다.

관련 정보는 USB 인터페이스에서 대체 설정을 선택하는 방법을 참조하세요.