IWDFIoRequest：：GetWriteParameters 方法 (wudfddi.h)

  • 项目

警告

UMDF 2 是最新版本的 UMDF，取代了 UMDF 1。 所有新的 UMDF 驱动程序都应使用 UMDF 2 编写。 未向 UMDF 1 添加新功能，并且较新版本的 Windows 10 上对 UMDF 1 的支持有限。 通用 Windows 驱动程序必须使用 UMDF 2。 有关详细信息，请参阅使用 UMDF 入门。

GetWriteParameters 方法检索写入类型请求的请求参数。

语法

void GetWriteParameters(
  [out, optional] SIZE_T   *pSizeInBytes,
  [out, optional] LONGLONG *pullOffset,
  [out, optional] ULONG    *pulKey
);

参数

[out, optional] pSizeInBytes

指向变量的指针，该变量接收要写入的大小（以字节为单位）。 若要检索数据以供写入，驱动程序会调用 IWDFIoRequest：：GetInputMemory 方法。

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

[out, optional] pullOffset

指向变量的指针，该变量接收偏移量（以字节为单位），开始写入设备或设备上的文件。 如果设备不支持绝对写入地址，则可以忽略 pullOffset 。 有关更多信息，请参见下面的“备注”部分。

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

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

[out, optional] pulKey

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

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

返回值

无

备注

如果请求类型不是写入类型，则对 GetWriteParameters 的 调用失败。

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

要求

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

另请参阅