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


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

Функция WinUsb_GetPipePolicy извлекает политику для определенного канала, связанного с конечной точкой на устройстве. Это синхронная операция.

Синтаксис

BOOL WinUsb_GetPipePolicy(
  [in]      WINUSB_INTERFACE_HANDLE InterfaceHandle,
  [in]      UCHAR                   PipeID,
  [in]      ULONG                   PolicyType,
  [in, out] PULONG                  ValueLength,
  [out]     PVOID                   Value
);

Параметры

[in] InterfaceHandle

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

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

[in] PipeID

8-разрядное значение, состоящее из 7-разрядного адреса и бита направления. Этот параметр соответствует полю bEndpointAddress в дескрипторе конечной точки.

[in] PolicyType

Переменная ULONG , указывающая извлекаемый параметр политики. Текущее значение параметра политики извлекается с помощью параметра Value . Сведения о поведении политик канала см. в разделе Функции WinUSB для изменения политики канала.

[in, out] ValueLength

Указатель на размер (в байтах) буфера, на который указывает Значение . В выходных данных ValueLength получает размер (в байтах) данных, скопированных в буфер значений .

[out] Value

Указатель на буфер, получающий указанное значение политики канала.

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

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

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

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

Требования

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

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

WinUSB

Функции WinUSB

Функции WinUSB для изменения политики канала

WinUsb_Initialize

WinUsb_ReadPipe

WinUsb_WritePipe