USBD_ParseDescriptors 함수(usbdlib.h)

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

구문

PUSB_COMMON_DESCRIPTOR USBD_ParseDescriptors(
  [in] PVOID DescriptorBuffer,
  [in] ULONG TotalLength,
  [in] PVOID StartPosition,
  [in] LONG  DescriptorType
);

매개 변수

[in] DescriptorBuffer

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

[in] TotalLength

DescriptorBuffer가 가리키는 버퍼의 크기(바이트)를 지정합니다.

[in] StartPosition

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

[in] DescriptorType

USB에서 할당한 설명자 형식 코드를 지정합니다. 다음 값은 USB 정의 설명자 유형에 유효합니다.

USB_STRING_DESCRIPTOR_TYPE

검색되는 설명자가 문자열 설명자임을 지정합니다.

USB_INTERFACE_DESCRIPTOR_TYPE

검색되는 설명자가 인터페이스 설명자임을 지정합니다.

USB_ENDPOINT_DESCRIPTOR_TYPE

검색할 설명자가 엔드포인트 설명자임을 지정합니다.

반환 값

USBD_ParseDescriptors 지정된 검색 조건과 일치하는 첫 번째 설명자의 머리인 USB_COMMON_DESCRIPTOR 구조체에 대한 포인터를 반환하거나 일치하는 항목이 없으면 NULL 이 반환됩니다.

설명

이 구조체는 설명자의 일부를 보유하는 데 사용되므로 USBD_ParseDescriptors 호출자가 설명자의 나머지 데이터에 액세스하는 데 사용할 올바른 구조를 결정할 수 있습니다. 모든 설명자 형식에는 데이터 시작 부분에 이러한 필드가 있으며 호출자는 bLength 및 bDescriptorType 멤버를 사용하여 이 설명자의 형식을 올바르게 식별할 수 있습니다.

이 루틴이 검색 조건과 일치하는 설명자를 찾는 구성 설명자를 구문 분석하면 첫 번째 일치 항목이 반환되어 검색이 종료됩니다.

요구 사항

추가 정보

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