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 |