通过

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。 有关详细信息，请参阅以下“备注”部分。

客户端应用程序在 Offset 中指定此值，OffsetHigh OVERLAPPED 结构的成员。 指向 OVERLAPPED 的指针在 Microsoft Win32 ReadFile 或 ReadFileEx 函数中传递。

此参数是可选的。 如果驱动程序不需要信息，驱动程序可以传递 NULL。

[out, optional] pulKey

指向一个变量的指针，该变量接收驱动程序可用于以驱动程序确定的方式对 I/O 请求进行排序的键。

此参数是可选的。 如果驱动程序不需要信息，驱动程序可以传递 NULL。

返回值

没有

言论

如果请求类型不是读取类型，则 GetReadParameters 调用失败。

对于支持寻址的设备（例如磁盘设备），pullOffset 参数指向的值通常是设备中的字节偏移量。 对于不支持寻址的设备（例如串行端口），驱动程序可以忽略 pullOffset的值。

尽管驱动程序可以选择为每个 pSizeInBytes、pullOffset和 pulKey 参数指定 NULL，但驱动程序必须为 GetReadParameters 指定至少一个非NULL 参数才能成功执行。

要求

要求 价值
终止支持 在 UMDF 2.0 及更高版本中不可用。
目标平台 桌面
最低 UMDF 版本 1.5
标头 wudfddi.h （包括 Wudfddi.h）
DLL WUDFx.dll

另请参阅