IO_SESSION_NOTIFICATION_FUNCTION回调函数 （wdm.h）
IO_SESSION_NOTIFICATION_FUNCTION函数类型定义回调例程，驱动程序通过该例程接收有关驱动程序感兴趣的用户会话状态更改的通知。
语法
IO_SESSION_NOTIFICATION_FUNCTION IoSessionNotificationFunction;
NTSTATUS IoSessionNotificationFunction(
[in] PVOID SessionObject,
[in] PVOID IoObject,
[in] ULONG Event,
[in] PVOID Context,
[in] PVOID NotificationPayload,
[in] ULONG PayloadLength
)
{...}
参数
[in] SessionObject
指向包含有关用户会话信息的不透明系统对象的指针。 驱动程序可以将此指针值作为 ContainerObject 参数值传递给 IoGetContainerInformation 例程。
[in] IoObject
指向驱动程序拥有的 I/O 对象的指针。 此参数是驱动程序以前注册以接收会话事件的通知时提供给 IoRegisterContainerNotification 例程的 I/O 对象指针。 IoRegisterContainerNotification 例程的 NotificationInformation 参数指向 IO_SESSION_STATE_NOTIFICATION 结构，该结构 IoObject 成员指向 I/O 对象。
[in] Event
一个 IO_SESSION_EVENT 枚举常量，该常量指示哪个会话事件导致了通知回调。
[in] Context
驱动程序注册接收会话事件的通知时，驱动程序之前提供给 IoRegisterContainerNotification 例程的上下文值。 在 IoRegisterContainerNotification 调用中，驱动程序提供了指向 IO_SESSION_STATE_NOTIFICATION 结构的指针，该结构 上下文 成员包含上下文值。
[in] NotificationPayload
指向包含 IO_SESSION_CONNECT_INFO 结构的有效负载缓冲区的指针。
[in] PayloadLength
NotificationPayload指向的缓冲区的大小（以字节为单位）。 缓冲区大小永远不会超过在 Wdm.h 头文件中定义的常量值IO_SESSION_MAX_PAYLOAD_SIZE。
返回值
如果例程成功，则必须返回STATUS_SUCCESS。 否则，它必须返回 Ntstatus.h 头文件中定义的错误状态值之一。
言论
内核模式驱动程序实现此例程。 I/O 管理器调用此例程来通知会话事件的驱动程序。
为了接收会话事件的通知，驱动程序调用 IoRegisterContainerNotification 例程，并将此例程的 CallbackFunction 参数设置为指向驱动程序IO_SESSION_NOTIFICATION_FUNCTION例程。 驱动程序传递给 IoRegisterContainerNotification 的 I/O 对象 确定驱动程序是否会在特定的用户会话或所有会话中接收事件的通知。 有关详细信息，请参阅 IO_SESSION_STATE_NOTIFICATION。
例子
若要定义 I/O 会话通知例程，必须先提供一个函数声明，用于标识要定义的回调例程的类型。 Windows 为驱动程序提供一组回调函数类型。 使用回调函数类型声明函数有助于 驱动程序代码分析、静态驱动程序验证程序（SDV）和其他验证工具查找错误，这是为 Windows作系统编写驱动程序的要求。
例如，若要定义名为 MyIoSessionNotification的 I/O 会话通知例程，请使用IO_SESSION_NOTIFICATION_FUNCTION类型，如以下代码示例所示：
IO_SESSION_NOTIFICATION_FUNCTION MyIoSessionNotification;
然后，按如下所示实现回调例程：
_Use_decl_annotations_
NTSTATUS
MyIoSessionNotification(
PVOID SessionObject,
PVOID IoObject,
ULONG Event,
PVOID Context,
PVOID NotificationPayload,
ULONG PayloadLength
)
{
// Function body
}
IO_SESSION_NOTIFICATION_FUNCTION函数类型在 Wdm.h 头文件中定义。 若要在运行代码分析工具时更准确地识别错误，请务必将 _Use_decl_annotations_ 注释添加到函数定义。
_Use_decl_annotations_ 批注可确保使用应用于头文件中IO_SESSION_NOTIFICATION_FUNCTION函数类型的批注。 有关函数声明要求的详细信息，请参阅 使用 WDM 驱动程序的函数角色类型来声明函数。 有关 _Use_decl_annotations_的信息，请参阅 批注函数行为。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 在 Windows 7 及更高版本的 Windows作系统中受支持。 |
| 目标平台 | 桌面 |
| 标头 | wdm.h （包括 Wdm.h、Ntddk.h、Ntifs.h、Fltkernel.h） |
| IRQL | 在 IRQL <调用 = APC_LEVEL。 |