USBD_ParseConfigurationDescriptorEx 함수(usbdlib.h)

USBD_ParseConfigurationDescriptorEx 루틴은 지정된 구성 설명자를 검색하고 지정된 검색 조건과 일치하는 인터페이스에 대한 포인터를 반환합니다.

구문

PUSB_INTERFACE_DESCRIPTOR USBD_ParseConfigurationDescriptorEx(
  [in] PUSB_CONFIGURATION_DESCRIPTOR ConfigurationDescriptor,
  [in] PVOID                         StartPosition,
  [in] LONG                          InterfaceNumber,
  [in] LONG                          AlternateSetting,
  [in] LONG                          InterfaceClass,
  [in] LONG                          InterfaceSubClass,
  [in] LONG                          InterfaceProtocol
);

매개 변수

[in] ConfigurationDescriptor

검색할 인터페이스가 포함된 USB 구성 설명자에 대한 포인터입니다.

[in] StartPosition

검색을 시작할 ConfigurationDescriptor에 제공된 구성 설명자 내의 주소에 대한 포인터입니다. 구성 설명자의 시작 부분에서 검색하려면 ConfigurationDescriptor 및 StartPosition 매개 변수가 동일한 주소여야 합니다.

[in] InterfaceNumber

검색할 인터페이스의 디바이스 정의 인덱스를 지정합니다. 검색 기준이 아니어야 하는 경우 -1로 설정해야 합니다.

[in] AlternateSetting

검색할 인터페이스의 디바이스 정의 대체 설정 인덱스를 지정합니다. 호출자가 대체 설정 값을 검색 기준으로 사용하지 않으려면 이 매개 변수를 -1로 설정해야 합니다.

[in] InterfaceClass

검색할 인터페이스의 인터페이스 클래스에 대한 디바이스 또는 USB 정의 식별자를 지정합니다. 호출자가 인터페이스 클래스 값을 검색 기준으로 사용하지 않으려면 이 매개 변수를 -1로 설정해야 합니다.

[in] InterfaceSubClass

검색할 인터페이스의 인터페이스 하위 클래스에 대한 디바이스 또는 USB 정의 식별자를 지정합니다. 호출자가 인터페이스 서브클래스 값을 검색 기준으로 사용하지 않으려면 이 매개 변수를 -1로 설정해야 합니다.

[in] InterfaceProtocol

검색할 인터페이스의 인터페이스 프로토콜에 대한 디바이스 또는 USB 정의 식별자를 지정합니다. 호출자가 인터페이스 프로토콜 값을 검색 기준으로 사용하지 않으려면 이 매개 변수를 -1로 설정해야 합니다.

반환 값

USBD_ParseConfigurationDescriptorEx 지정된 검색 조건과 일치하는 첫 번째 인터페이스 설명자에 대한 포인터를 반환합니다. 검색 조건과 일치하는 인터페이스가 없으면 NULL을 반환합니다.

설명

호출자는 이 루틴을 사용하여 구성 설명자 내에서 인터페이스를 찾을 때 검색 조건(InterfaceNumber, AlternateSetting, InterfaceClass, InterfaceSubClass 및 InterfaceProtocol)을 둘 이상 지정할 수 있습니다. 예제 코드는 USBD_CreateConfigurationRequestEx 참조하세요.

이 루틴이 검색 조건과 일치하는 인터페이스 설명자를 찾는 구성 설명자를 구문 분석하면 첫 번째 일치 항목이 반환되어 검색이 종료됩니다. 호출자는 원하는 인터페이스를 찾는 데 필요한 만큼 검색 조건을 지정해야 합니다.

요구 사항

추가 정보

USB 디바이스 드라이버 프로그래밍 참조

USB_CONFIGURATION_DESCRIPTOR