структура IO_SESSION_STATE_NOTIFICATION (wdm.h)

Статья
08/08/2023

Структура IO_SESSION_STATE_NOTIFICATION содержит сведения, которые драйвер в режиме ядра предоставляет подпрограмме IoRegisterContainerNotification , когда драйвер регистрируется для получения уведомлений о событиях сеанса.

Синтаксис

typedef struct _IO_SESSION_STATE_NOTIFICATION {
  ULONG Size;
  ULONG Flags;
  PVOID IoObject;
  ULONG EventMask;
  PVOID Context;
} IO_SESSION_STATE_NOTIFICATION, *PIO_SESSION_STATE_NOTIFICATION;

Члены

Size

Размер структуры IO_SESSION_STATE_NOTIFICATION в байтах.

Flags

В настоящее время для этого элемента не определены флаги. Задайте нулевое значение.

IoObject

Указатель на объект ввода-вывода, принадлежащий драйверу. Этот элемент может указывать на структуру DEVICE_OBJECT, DRIVER_OBJECT или FILE_OBJECT . Объект ввода-вывода должен оставаться действительным в течение всего времени существования регистрации. Перед удалением зарегистрированного объекта устройства, выгрузкой зарегистрированного драйвера или закрытием зарегистрированного объекта файла вызовите процедуру IoUnregisterContainerNotification , чтобы отменить регистрацию. Драйвер может поддерживать одновременную регистрацию для нескольких объектов ввода-вывода, но не может создать более одной активной регистрации для одного объекта ввода-вывода.

EventMask

Маскирование битов для событий сеанса. Эти биты маски указывают на события, для которых драйвер запрашивает уведомления.

Чтобы зарегистрироваться для получения уведомлений о событиях сеанса, драйвер в режиме ядра вызывает подпрограмму IoRegisterContainerNotification . Чтобы указать события сеанса, для которых драйвер хочет получать уведомления, драйвер задает элемент EventMask этой структуры в побитовое ИЛИ одной или нескольких констант IO_SESSION_STATE_XXX .

Задайте для этого элемента побитовое ИЛИ одной или нескольких из следующих констант IO_SESSION_STATE_XXX :

Значение	Значение
IO_SESSION_STATE_ALL_EVENTS 0xffffffff	Отправлять уведомления обо всех событиях сеанса.
IO_SESSION_STATE_CREATION_EVENT 0x00000001	Отправка уведомления при создании сеанса пользователя.
IO_SESSION_STATE_TERMINATION_EVENT 0x00000002	Отправка уведомления по завершении сеанса пользователя.
IO_SESSION_STATE_CONNECT_EVENT 0x00000004	Отправка уведомления при подключении сеанса пользователя.
IO_SESSION_STATE_DISCONNECT_EVENT 0x00000008	Отправка уведомления при отключении сеанса пользователя.
IO_SESSION_STATE_LOGON_EVENT 0x00000010	Отправка уведомления при входе пользователя в сеанс.
IO_SESSION_STATE_LOGOFF_EVENT 0x00000020	Отправка уведомления при выходе пользователя из сеанса.
IO_SESSION_STATE_VALID_EVENT_MASK 0x0000003f	Отправка уведомления при возникновении любого типа события сеанса.

Context

Указатель на буфер контекста, в котором драйвер может хранить свои личные данные для регистрации уведомления определенного сеанса. Диспетчер ввода-вывода передает этот указатель в подпрограмму обратного вызова уведомлений драйвера (задается параметром CallbackFunction процедуры IoRegisterContainerNotification). Диспетчер ввода-вывода не пытается проверить указатель контекста или получить доступ к буферу, на который он указывает. Этот элемент может иметь значение NULL , если драйверу не требуется буфер контекста.

Эта структура используется подпрограммой IoRegisterContainerNotification . Драйвер, вызывающий IoRegisterContainerNotification , использует эту структуру для указания уведомлений о событиях сеанса, для регистрации.

Объект устройства для каждого сеанса представляет устройство, доступ к которому может получить только определенный сеанс пользователя. Если драйвер задает элемент IoObject , указывающий на объект устройства, который является объектом устройства для каждого сеанса, IoRegisterContainerNotification регистрирует драйвер для получения только уведомлений о событиях, происходящих в сеансе, представленном объектом устройства. Если IoObject указывает на объект устройства, который не является объектом устройства для каждого сеанса, или ioObject указывает на объект, который не является объектом устройства, IoRegisterContainerNotification регистрирует драйвер для получения уведомлений о событиях, происходящих во всех сеансах на компьютере.

Чтобы определить, является ли объект устройства объектом устройства для каждого сеанса, драйвер может вызвать подпрограмму IoGetDevicePropertyData для запроса ключа свойства DEVPKEY_Device_SessionId в хранилище свойств объекта устройства. Если свойство DEVPKEY_Device_SessionId существует и для свойства задано значение ненулевого идентификатора сеанса служб терминалов , то объект устройства является объектом устройства для каждого сеанса. Дополнительные сведения см. в разделе DEVPKEY_Device_SessionId.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается в Windows 7 и более поздних версиях операционной системы Windows.
Верхняя часть	wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h, Fltkernel.h)