KsReadFile 函数 (ks.h)

KsReadFile 函数对指定的文件对象执行读取。 假定调用方正在序列化对文件的访问权限，以便针对FO_SYNCHRONOUS_IO文件对象执行操作。 如果可能，该函数会尝试使用 FastIoDispatch ，或者针对设备对象生成读取请求。 所有相关统计信息都会更新。

语法

KSDDKAPI NTSTATUS KsReadFile(
  [in]           PFILE_OBJECT     FileObject,
  [in, optional] PKEVENT          Event,
  [in, optional] PVOID            PortContext,
  [out]          PIO_STATUS_BLOCK IoStatusBlock,
  [out]          PVOID            Buffer,
  [in]           ULONG            Length,
  [in, optional] ULONG            Key,
  [in]           KPROCESSOR_MODE  RequestorMode
);

参数

[in] FileObject

指定要对其执行读取的文件对象。

[in, optional] Event

（可选）包含要用于读取的事件。 如果未传递任何事件，则假定调用针对同步文件对象。 否则，调用方正在等待文件对象的 事件，或者可能异步完成。 如果已为同步 I/O 打开文件，则必须为 NULL。 如果使用变量，它必须是对象管理器分配的事件。

[in, optional] PortContext

（可选）包含完成端口的上下文信息。

[out] IoStatusBlock

指定要返回状态信息的地址。 无论请求者模式如何，始终假定这是有效的地址。

[out] Buffer

指定要在其中放置数据读取的缓冲区。 如果需要探测和锁定缓冲区，则将使用异常处理程序和 RequesterMode。

[in] Length

指定传递的缓冲区的大小。

[in, optional] Key

（可选）包含一个键，如果没有，则为零

[in] RequestorMode

指示在需要生成 IRP 时要置于读取 IRP 中的处理器模式。 此外，如果需要探测和锁定缓冲区，则使用此缓冲区。 此变量还确定是否可以执行快速 I/O 调用。 如果请求者模式不是 KernelMode，但以前的模式为 ，则无法使用快速 I/O。

返回值

如果成功， KsReadFile 函数将返回STATUS_SUCCESS;如果操作挂起，则返回STATUS_PENDING;如果操作未成功，则返回读取错误。

要求

要求	值
目标平台	通用
标头	ks.h (包括 Ks.h)
Library	Ks.lib