SpbRequestComplete 函数 (spbcx.h)

SpbRequestComplete 方法完成 I/O 请求并提供完成状态。

语法

void SpbRequestComplete(
  [in] SPBREQUEST Request,
  [in] NTSTATUS   CompletionStatus
);

参数

[in] Request

要完成的 I/O 请求的 SPBREQUEST 句柄。 SPB 控制器驱动程序以前通过其注册 的事件回调函数之一接收此句柄。

[in] CompletionStatus

表示请求完成状态的 NTSTATUS 值。 有效状态值包括但不限于以下内容:

STATUS_SUCCESS

I/O 请求已成功完成。

STATUS_CANCELLED

I/O 请求已取消。

STATUS_UNSUCCESSFUL

驱动程序在处理 I/O 请求时遇到错误。

返回值

备注

控制器驱动程序调用此方法以完成之前在以下回调之一期间收到的 I/O 请求:

EvtSpbControllerIoOtherEvtSpbControllerIoReadEvtSpbControllerIoSequenceEvtSpbControllerIoWrite 调用 SpbRequestComplete 而不是 WdfRequestComplete 方法,以完成上述列表中的回调函数收到的 I/O 请求。

如果调用方提供无效的 SPBREQUEST 句柄,则会发生 bug 检查。

调用 SpbRequestComplete 表示处理 I/O 请求的最后阶段。 此方法返回时, 请求 句柄值不再有效。

要求

要求
最低受支持的客户端 从Windows 8开始可用。
目标平台 通用
标头 spbcx.h
Library Spbcxstubs.lib
IRQL <= DISPATCH_LEVEL

另请参阅

EvtSpbControllerIoOther

EvtSpbControllerIoRead

EvtSpbControllerIoSequence

EvtSpbControllerIoWrite

SPBREQUEST

WdfRequestComplete