EVT_SPB_TARGET_DISCONNECT回调函数 （spbcx.h）
SPB 控制器驱动程序的 EvtSpbTargetDisconnect 事件回调函数关闭了与目标设备的连接，而目标设备以前是通过调用驱动程序的 EvtSpbTargetConnect 事件回调函数打开的。
语法
EVT_SPB_TARGET_DISCONNECT EvtSpbTargetDisconnect;
void EvtSpbTargetDisconnect(
[in] WDFDEVICE Controller,
[in] SPBTARGET Target
)
{...}
参数
[in] Controller
表示 SPB 控制器的 框架设备对象的 WDFDEVICE 句柄。
[in] Target
要关闭的目标 SPBTARGET 句柄。 目标是附加到总线的外围设备或端口。 SPB 框架扩展（SpbCx）以前将此句柄分配给 EvtSpbTargetConnect 回调中打开了与目标的连接。
返回值
没有
言论
SPB 控制器驱动程序对此函数的实现是可选的。
SpbCx 管理 SPB 控制器的 I/O 队列。 如果 SPB 控制器驱动程序注册 EvtSpbTargetDisconnect 回调函数，则当控制器驱动程序的客户端（外围驱动程序）发送 IRP_MJ_CLOSE 请求以关闭 SPBTARGET 句柄时，SpbCx 将调用此函数。 此句柄表示客户端在上一个 IRP_MJ_CREATE 请求中打开的总线上与目标设备的连接。 如果 EvtSpbTargetDisconnect 函数返回错误代码，SpbCx 将失败 IRP_MJ_CLOSE 请求。
EvtSpbTargetDisconnect 函数在客户端启动的所有 I/O作结束后以及客户端解锁控制器后（如果客户端以前锁定了控制器）之后，从客户端的关闭线程的上下文中同步调用。
如果 SPB 控制器驱动程序已分配 I/O 请求并将其发送到目标设备的 I/O 请求链中的下一个较低驱动程序，EvtSpbTargetDisconnect 函数应在返回之前取消这些请求。
EvtSpbTargetDisconnect 回调返回后，可以随时调用客户端驱动程序的 DispatchCleanup 和 CreateProcessNotifyEx 回调例程。 当客户端驱动程序的进程退出时，其 CreateProcessNotifyEx 例程在最后一个线程退出进程之前被调用。
若要注册 EvtSpbTargetDisconnect 回调函数，请调用 SpbDeviceInitialize 方法。
例子
若要定义 EvtSpbTargetDisconnect 回调函数，必须首先提供一个函数声明，用于标识要定义的回调函数的类型。 Windows 为驱动程序提供一组回调函数类型。 使用回调函数类型声明函数有助于 驱动程序代码分析、静态驱动程序验证程序（SDV）和其他验证工具查找错误，这是为 Windows作系统编写驱动程序的要求。
例如，若要定义名为 MyEvtSpbTargetDisconnect的 EvtSpbTargetDisconnect 回调函数，请使用EVT_SPB_TARGET_DISCONNECT函数类型，如以下代码示例所示：
EVT_SPB_TARGET_DISCONNECT MyEvtSpbTargetDisconnect;
然后，按如下所示实现回调函数：
_Use_decl_annotations_
VOID
MyEvtSpbTargetDisconnect(
WDFDEVICE Controller,
SPBTARGET Target
)
{ ... }
EVT_SPB_TARGET_DISCONNECT函数类型在 Spbcx.h 头文件中定义。 若要在运行代码分析工具时更准确地识别错误，请务必将 Use_decl_annotations 注释添加到函数定义。 Use_decl_annotations 批注可确保使用应用于头文件中EVT_SPB_TARGET_DISCONNECT函数类型的批注。 有关函数声明要求的详细信息，请参阅 使用 KMDF 驱动程序的函数角色类型声明函数。 有关 Use_decl_annotations的详细信息，请参阅 批注函数行为。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 从 Windows 8 开始支持。 |
| 目标平台 | 桌面 |
| 标头 | spbcx.h |
| IRQL | 在PASSIVE_LEVEL调用。 |