IWDFUsbTargetPipe::RetrievePipePolicy 方法 (wudfusb.h)
[警告: UMDF 2 是最新版本的 UMDF,并取代 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 不会向 UMDF 1 添加任何新功能,并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息,请参阅使用 UMDF 入门。]
RetrievePipePolicy 方法检索 WinUsb 管道策略。
语法
HRESULT RetrievePipePolicy(
[in] ULONG PolicyType,
[in, out] ULONG *ValueLength,
[out] PVOID Value
);
参数
[in] PolicyType
UMDF 驱动程序请求的 WinUsb 管道策略的类型。
[in, out] ValueLength
指向变量的指针,该变量在输入时包含 RetrievePipePolicy 为 Value 提供的缓冲区的大小(以字节为单位)。 在输出时,此参数包含 RetrievePipePolicy 为 Value 所需的大小。
[out] Value
一个指针,用于接收包含 WinUsb 管道策略的缓冲区。
返回值
RetrievePipePolicy 返回以下值之一:
返回代码 | 说明 |
---|---|
|
RetrievePipePolicy 已成功检索 WinUsb 管道策略。 |
|
RetrievePipePolicy 遇到分配失败。 |
|
此值对应于 WinUsb API 返回的错误代码。 |
注解
管道策略控制 USB 管道 (的行为,例如超时、处理短数据包等) 。
有关 UMDF 驱动程序可为 PolicyType 参数传递的有效策略类型以及框架返回的值的详细信息,请参阅 WinUsb_GetPipePolicy 函数。
有关管道策略的行为的信息,请参阅 用于管道策略修改的 WinUSB Functions。
RetrievePipePolicy 方法生成 UMDF 请求,并将请求同步发送到 I/O 目标。
要求
要求 | 值 |
---|---|
结束支持 | 在 UMDF 2.0 及更高版本中不可用。 |
目标平台 | 桌面 |
最低 UMDF 版本 | 1.5 |
标头 | wudfusb.h (包括 Wudfusb.h) |
DLL | WUDFx.dll |
另请参阅
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈