WinUsb_SetCurrentAlternateSetting 함수(winusb.h)

WinUsb_SetCurrentAlternateSetting 함수는 인터페이스의 대체 설정을 설정합니다.

구문

BOOL WinUsb_SetCurrentAlternateSetting(
  [in] WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in] UCHAR                   SettingNumber
);

[in] InterfaceHandle

설정할 대체 설정을 정의하는 인터페이스에 대한 불투명 핸들입니다.

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

[in] SettingNumber

USB_INTERFACE_DESCRIPTOR 구조체의 bAlternateSetting 멤버에 포함된 값입니다. 이 구조체는 WinUsb_QueryInterfaceSettings 루틴으로 채워집니다.

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

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

반환 코드	설명
ERROR_INVALID_HANDLE	호출자가 InterfaceHandle 매개 변수에서 NULL을 전달했습니다.

인터페이스 에 미해결 I/O 요청이 있으면 WinUsb_SetCurrentAlternateSetting 실패합니다.