当对等断开连接时,NDK 提供程序调用 NdkDisconnectEventCallbackEx (NDK_FN_DISCONNECT_EVENT_CALLBACK_EX) 函数。
语法
NDK_FN_DISCONNECT_EVENT_CALLBACK_EX NdkFnDisconnectEventCallbackEx;
VOID NdkFnDisconnectEventCallbackEx(
[in, optional] PVOID DisconnectEventContext,
[in] ULONG ProviderDisconnectReason
)
{...}
参数
[in, optional] DisconnectEventContext
在创建完成队列 (CQ) 对象时,在 NdkCompleteConnectEx (NDK_FN_COMPLETE_CONNECT_EX) 或 NdkAcceptEx (NDK_FN_ACCEPT_EX) 函数的 DisconnectEvent 参数中指定的上下文区域。
[in] ProviderDisconnectReason
提供程序特定的代码,指示连接断开连接的原因。
零 表示 NDK 提供程序尚不支持断开连接原因功能或未提供。
返回值
没有
言论
注意
此例程由 NDK 使用者实现,并传递给 NDK 提供程序。
NdkDisconnectEventCallbackEx 是连接断开连接事件的回调函数。 为与发起程序端的 NdkCompleteConnectEx(NDK_FN_COMPLETE_CONNECT_EX) 函数以及侦听器端的 NdkAcceptEx(NDK_FN_ACCEPT_EX) 函数的连接指定断开连接通知回调函数。 NDK 提供程序仅在对等方断开连接时调用此回调一次。 由于来自对等方的传入断开连接请求,提供程序不应刷新未完成的工作请求。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | NDKPI 2.1 及更高版本中受支持。 |
| 支持的最低服务器 | Windows Server 2022 |
| 目标平台 | 窗户 |
| 标头 | ndkpi.h (包括 Ndkpi.h) |
| IRQL | <=DISPATCH_LEVEL |