функция WinUsb_AbortPipe (winusb.h)

Статья
08/27/2023

Функция WinUsb_AbortPipe прерывает все ожидающие передачи для канала. Это синхронная операция.

Синтаксис

BOOL WinUsb_AbortPipe(
  [in] WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in] UCHAR                   PipeID
);

Параметры

[in] InterfaceHandle

Непрозрачный дескриптор интерфейса, содержащего конечную точку, с которой связан канал.

Чтобы прервать передачу по каналу, связанному с конечной точкой в первом интерфейсе, используйте дескриптор, возвращенный WinUsb_Initialize. Для всех остальных интерфейсов используйте дескриптор целевого интерфейса, полученный WinUsb_GetAssociatedInterface.

[in] PipeID

Идентификатор (ID) канала управления. Параметр PipeID — это 8-битовое значение, состоящее из 7-разрядного адреса и бита направления. Этот параметр соответствует полю bEndpointAddress в дескрипторе конечной точки.

Возвращаемое значение

WinUsb_AbortPipe возвращает значение TRUE , если операция выполнена успешно. В противном случае эта подпрограмма возвращает значение FALSE, и вызывающий объект может получить зарегистрированную ошибку, вызвав Метод GetLastError.

GetLastError может вернуть следующий код ошибки.

Код возврата	Описание
ERROR_INVALID_HANDLE	Вызывающий объект передал значение NULL в параметре InterfaceHandle .

Требования

Требование	Значение
Целевая платформа	Универсальное
Верхняя часть	winusb.h (включая Winusb.h)
Библиотека	Winusb.lib
DLL	Winusb.dll

См. также раздел

Поделиться через