WinUsb_GetAssociatedInterface 함수(winusb.h)

WinUsb_GetAssociatedInterface 함수는 연결된 인터페이스에 대한 핸들을 검색합니다. 동기 작업입니다.

구문

BOOL WinUsb_GetAssociatedInterface(
  [in]  WINUSB_INTERFACE_HANDLE  InterfaceHandle,
  [in]  UCHAR                    AssociatedInterfaceIndex,
  [out] PWINUSB_INTERFACE_HANDLE AssociatedInterfaceHandle
);

매개 변수

[in] InterfaceHandle

WinUsb_Initialize 반환되는 디바이스의 첫 번째(기본) 인터페이스에 대한 불투명 핸들입니다.

[in] AssociatedInterfaceIndex

검색할 연결된 인터페이스를 지정하는 인덱스입니다. 값 0은 첫 번째 연결된 인터페이스를 나타내고, 값 1은 연결된 두 번째 인터페이스 등을 나타냅니다.

[out] AssociatedInterfaceHandle

연결된 인터페이스에 대한 핸들입니다. 호출자는 이 인터페이스 핸들을 Winusb.dll 의해 노출된 WinUSB 함수 에 전달해야 합니다. 이 핸들을 닫려면 WinUsb_Free 호출합니다.

반환 값

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

반환 코드	설명
ERROR_ALREADY_EXISTS	WinUsb_GetAssociatedInterfaceAssociatedInterfaceIndex 가 지정하는 인터페이스에 대한 핸들을 이미 반환했습니다.
ERROR_INVALID_HANDLE	호출자가 InterfaceHandle 매개 변수에서 NULL을 전달했습니다.
ERROR_INVALID_PARAMETER	전달된 AssociatedInterfaceIndex 값이 정수 오버플로 검사 실패했습니다.
ERROR_NO_MORE_ITEMS	지정된 AssociatedInterfaceIndex 값에 대한 인터페이스가 없습니다.
ERROR_NOT_ENOUGH_MEMORY	작업을 수행할 메모리가 부족했음을 나타냅니다.

설명

WinUsb_GetAssociatedInterface 루틴은 불투명 핸들을 검색합니다.

첫 번째 연결된 인터페이스는 WinUsb_Initialize 루틴이 검색하는 인터페이스 바로 뒤에 있는 인터페이스입니다.

WinUsb_GetAssociatedInterface 반환하는 핸들은 WinUsb_Free 호출하여 해제해야 합니다.

WinUsb_GetAssociatedInterface 호출자는 각 인터페이스에 대해 하나의 핸들만 검색할 수 있습니다. 호출자가 동일한 인터페이스에 대해 둘 이상의 핸들을 검색하려고 하면 루틴이 실패하고 ERROR_ALREADY_EXISTS 오류가 발생합니다.

요구 사항

요구 사항	값
대상 플랫폼	유니버설
헤더	winusb.h(Winusb.h 포함)
라이브러리	Winusb.lib
DLL	Winusb.dll

추가 정보

WinUSB

WinUSB 함수

WinUsb_Initialize