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

由 7 位地址和方向位组成的 8 位值。 此参数对应于终结点描述符中的 bEndpointAddress 字段。

[in] PolicyType

指定要检索的策略参数的 ULONG 变量。 检索策略参数的当前值 Value 参数。 有关管道策略的行为的信息,请参阅 用于管道策略修改的 WinUSB 函数

[in, out] ValueLength

指向 Value 指向的缓冲区的大小(以字节为单位)的指针。 输出时, ValueLength 接收复制到 Value 缓冲区的数据的大小(以字节为单位)。

[out] Value

指向接收指定管道策略值的缓冲区的指针。

返回值

如果操作成功,WinUsb_GetPipePolicy返回 TRUE。 否则,此例程返回 FALSE,调用方可以通过调用 GetLastError 检索记录的错误。

GetLastError 可能会返回以下错误代码。

返回代码 说明
ERROR_INVALID_HANDLE
调用 方在InterfaceHandle 参数中传递 NULL。

要求

   
目标平台 通用
标头 winusb.h (包括 Winusb.h)
Library Winusb.lib
DLL Winusb.dll

另请参阅

WinUSB

WinUSB 函数

用于修改管道策略的 WinUSB 函数

WinUsb_Initialize

WinUsb_ReadPipe

WinUsb_ReadPipe