WinUsb_QueryInterfaceSettings 함수(winusb.h)

아티클
03/13/2024

WinUsb_QueryInterfaceSettings 함수는 특정 인터페이스 핸들에 대해 지정된 대체 인터페이스 설정에 대한 인터페이스 설명자를 검색합니다.

구문

BOOL WinUsb_QueryInterfaceSettings(
  [in]  WINUSB_INTERFACE_HANDLE   InterfaceHandle,
  [in]  UCHAR                     AlternateInterfaceNumber,
  [out] PUSB_INTERFACE_DESCRIPTOR UsbAltInterfaceDescriptor
);

매개 변수

[in] InterfaceHandle

선택한 구성의 인터페이스에 대한 불투명 핸들입니다.

첫 번째 인터페이스의 설정을 검색하려면 WinUsb_Initialize 반환된 핸들을 사용합니다. 다른 모든 인터페이스의 경우 WinUsb_GetAssociatedInterface 검색된 대상 인터페이스에 대한 핸들을 사용합니다.

[in] AlternateInterfaceNumber

반환할 대체 설정을 나타내는 값입니다. 값 0은 첫 번째 대체 설정을 나타내고, 값 1은 두 번째 대체 설정을 나타내는 등입니다.

[out] UsbAltInterfaceDescriptor

AlternateSettingNumber가 지정한 인터페이스에 대한 정보를 포함하는 호출자가 할당한 USB_INTERFACE_DESCRIPTOR 구조체에 대한 포인터입니다.

반환 값

WinUsb_QueryInterfaceSettings 작업이 성공하면 TRUE 를 반환합니다. 그렇지 않으면 FALSE를 반환하고 호출자는 GetLastError를 호출하여 기록된 오류를 검색할 수 있습니다.

GetLastError 는 다음 오류 코드를 반환할 수 있습니다.

반환 코드	설명
ERROR_INVALID_HANDLE	호출자가 InterfaceHandle 매개 변수에서 NULL을 전달했습니다.
ERROR_NO_MORE_ITEMS	지정된 대체 인터페이스를 찾을 수 없습니다.

설명

WinUsb_QueryInterfaceSettings 이전에 WinUsb_Initialize 검색한 구성 설명자를 구문 분석합니다. 자세한 내용은 WinUsb_Initialize 대한 설명 섹션을 참조하세요.

WinUsb_QueryInterfaceSettings 호출은 AlternateSettingNumber에서 호출자가 전달한 인터페이스 인덱스에 지정된 대체 인터페이스에 대해 인터페이스 배열을 검색합니다. 지정된 인터페이스가 발견되면 함수는 호출자가 할당한 USB_INTERFACE_DESCRIPTOR 구조를 채웁니다. 지정된 인터페이스를 찾을 수 없으면 ERROR_NO_MORE_ITEMS 코드와 함께 호출이 실패합니다.