IWDFIoRequest::GetReadParameters 方法 (wudfddi.h)
警告
UMDF 2 是 UMDF 的最新版本,取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 不会向 UMDF 1 添加任何新功能,并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息,请参阅使用 UMDF 入门。
GetReadParameters 方法检索读取类型请求的请求参数。
语法
void GetReadParameters(
[out, optional] SIZE_T *pSizeInBytes,
[out, optional] LONGLONG *pullOffset,
[out, optional] ULONG *pulKey
);
参数
[out, optional] pSizeInBytes
指向变量的指针,该变量接收要读取的大小(以字节为单位)。 若要检索要读取的数据,驱动程序会调用 IWDFIoRequest::GetOutputMemory 方法。
此参数是可选的。 如果驱动程序不需要信息,则可以传递 NULL 。
[out, optional] pullOffset
指向变量的指针,该变量接收偏移量(以字节为单位)以开始从设备或设备上的文件进行读取。 如果设备不支持绝对读取地址,可以忽略 pullOffset 。 有关更多信息,请参见下面的“备注”部分。
客户端应用程序在 OVERLAPPED 结构的 Offset 和 OffsetHigh 成员中指定此值。 指向 OVERLAPPED 的指针在 Microsoft Win32 ReadFile 或 ReadFileEx 函数中传递。
此参数是可选的。 如果驱动程序不需要信息,则可以传递 NULL 。
[out, optional] pulKey
指向变量的指针,该变量接收密钥,驱动程序可以使用该键按驱动程序确定的方式对 I/O 请求进行排序。
此参数是可选的。 如果驱动程序不需要信息,则可以传递 NULL 。
返回值
无
备注
如果请求类型不是读取类型,则对 GetReadParameters 的 调用失败。
例如,对于支持寻址 (的设备,磁盘设备 ) ,pullOffset 参数指向的值通常是设备中的字节偏移量。 例如,对于不支持寻址 (的设备,串行端口) ,驱动程序可以忽略 pullOffset 中的值。
尽管驱动程序可以选择为每个 pSizeInBytes、pullOffset 和 pulKey 参数指定 NULL,但驱动程序必须为 GetReadParameter 指定至少一个非 NULL 参数才能成功执行。
要求
要求 | 值 |
---|---|
结束支持 | 在 UMDF 2.0 及更高版本中不可用。 |
目标平台 | 桌面 |
最低 UMDF 版本 | 1.5 |
标头 | wudfddi.h (包括 Wudfddi.h) |
DLL | WUDFx.dll |