WinUsb_QueryPipeEx 함수(winusb.h)

아티클
08/27/2023

WinUsb_QueryPipeEx 함수는 인터페이스에 대해 지정된 엔드포인트 및 연결된 파이프에 대한 확장 정보를 검색합니다.

구문

BOOL WinUsb_QueryPipeEx(
  [in]  WINUSB_INTERFACE_HANDLE     InterfaceHandle,
  [in]  UCHAR                       AlternateSettingNumber,
  [in]  UCHAR                       PipeIndex,
  [out] PWINUSB_PIPE_INFORMATION_EX PipeInformationEx
);

매개 변수

[in] InterfaceHandle

파이프가 연결된 엔드포인트를 포함하는 인터페이스에 대한 불투명 핸들입니다.

첫 번째 인터페이스에서 엔드포인트와 연결된 파이프를 쿼리하려면 WinUsb_Initialize 반환된 핸들을 사용합니다. 다른 모든 인터페이스의 경우 WinUsb_GetAssociatedInterface 검색된 대상 인터페이스에 대한 핸들을 사용합니다.

[in] AlternateSettingNumber

정보를 반환할 대체 인터페이스를 지정하는 값입니다.

[in] PipeIndex

정보를 반환할 파이프를 지정하는 값입니다. 이 값은 엔드포인트 설명자의 bEndpointAddress 필드와 동일하지 않습니다. PipeIndex 값 0은 인터페이스와 연결된 첫 번째 엔드포인트를 의미하고, 값 1은 두 번째 엔드포인트를 나타내는 등입니다. PipeIndex 는 인터페이스 설명자의 bNumEndpoints 필드에 있는 값보다 작아야 합니다.

[out] PipeInformationEx

출력에서 파이프 정보를 포함하는 호출자가 할당한 WINUSB_PIPE_INFORMATION_EX 구조체에 대한 포인터입니다.

반환 값

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

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

반환 코드	설명
ERROR_INVALID_HANDLE	호출자가 InterfaceHandle 매개 변수에서 NULL을 전달했습니다.
ERROR_INVALID_PARAMETER	호출자가 PipeInformation 매개 변수에서 NULL을 전달했습니다. InterfaceHandle에 지정된 핸들에 대한 인터페이스 설명자를 찾을 수 없습니다.
ERROR_NO_MORE_ITEMS	PipeIndex 매개 변수에 전달된 값이 인터페이스 설명자의 bNumEndpoints 값보다 큽니다. 지정된 인터페이스에 대한 엔드포인트 설명자를 찾을 수 없습니다.