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


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

Функция WinUsb_RegisterIsochBuffer регистрирует буфер, используемый для изохронной передачи.

Синтаксис

BOOL WinUsb_RegisterIsochBuffer(
  [in]  WINUSB_INTERFACE_HANDLE     InterfaceHandle,
  [in]  UCHAR                       PipeID,
  [in]  PUCHAR                      Buffer,
  [in]  ULONG                       BufferLength,
  [out] PWINUSB_ISOCH_BUFFER_HANDLE IsochBufferHandle
);

Параметры

[in] InterfaceHandle

Непрозрачный дескриптор интерфейса в выбранной конфигурации. Этот дескриптор должен быть создан предыдущим вызовом WinUsb_Initialize или WinUsb_GetAssociatedInterface.

[in] PipeID

Производный от бита 3...0 поля bEndpointAddress в дескрипторе конечной точки.

[in] Buffer

Указатель на регистримый буфер передачи.

[in] BufferLength

Длина буфера передачи в байтах, на который указывает буфер.

[out] IsochBufferHandle

Получает непрозрачный дескриптор зарегистрированного буфера. Этот дескриптор требуется другим функциям WinUSB, которые выполняют изохронную передачу. Чтобы освободить дескриптор, вызовите функцию WinUsb_UnregisterIsochBuffer .

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

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

Если вызывающий объект для параметра ContinueStream имеет значение TRUE, передача завершается ошибкой, если Winusb.sys не может запланировать передачу, чтобы продолжить поток без удаления одного или нескольких кадров.

Комментарии

Перед началом изохронной передачи данных в буфер или из буфера вызывающий объект должен зарегистрировать буфер с помощью WinUsb_RegisterIsochBuffer. Этот вызов позволяет Winusb.sys предварительно сопоставлять и блокировать буфер после всех последующих передач с помощью буфера.

Требования

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

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

Отправка изохронных передач по USB из классического приложения WinUSB

Функции WinUSB

WinUsb_UnregisterIsochBuffer