Уведомления VDS

[Начиная с Windows 8 и Windows Server 2012 COM-интерфейс службы виртуальных дисков заменен API управления хранилищем Windows.]

Поставщик может отправлять уведомления о событиях в VDS, а VDS, в свою очередь, перенаправлять уведомление в приложения. Модель уведомлений, используемая VDS, похожа на модель точки подключения, используемую COM-объектами.

VDS создает уведомления службы для таких событий, как назначение буквы диска или получение нераспределенного диска. После того как VDS выделяет диск поставщику, поставщик отвечает за создание связанных уведомлений. На следующем рисунке показаны интерфейсы и методы, используемые в модели уведомлений VDS.

Для получения уведомлений VDS регистрирует интерфейс IVdsAdviseSink с объектом поставщика, вызывая метод IVdsProviderPrivate::OnLoad и передавая указатель на интерфейс. При возникновении события уведомления, например при поступлении нового тома или диска, поставщик передает соответствующую структуру уведомлений в VDS в качестве параметра метода IVdsAdviseSink::OnNotify .

Процесс приложения и VDS аналогичен. В частности, для получения уведомлений приложение регистрирует свой интерфейс IVdsAdviseSink в VDS путем вызова метода IVdsService::Advise и передачи указателя на интерфейс. Когда служба VDS получает уведомление от поставщика, она передает соответствующую структуру уведомлений зарегистрированным приложениям в качестве параметра метода IVdsAdviseSink::OnNotify .

Примечание

Приложение, которое вызывает Совет , должно в конечном итоге вызвать метод IVdsService::Unadvise . В идеале он должен вызывать Unadvise , как только ему больше не нужно получать уведомления.

 

В следующей таблице перечислены уведомления, созданные поставщиком по типу объекта.

Объект	Уведомление	Значение	Ссылка на описание события
Pack	VDS_NF_PACK_ARRIVE	1	VDS_PACK_NOTIFICATION
Pack	VDS_NF_PACK_DEPART	2	VDS_PACK_NOTIFICATION
Pack	VDS_NF_PACK_MODIFY	3	VDS_PACK_NOTIFICATION
Громкость	VDS_NF_VOLUME_ARRIVE	4	VDS_VOLUME_NOTIFICATION
Громкость	VDS_NF_VOLUME_DEPART	5	VDS_VOLUME_NOTIFICATION
Громкость	VDS_NF_VOLUME_MODIFY	6	VDS_VOLUME_NOTIFICATION
Громкость	VDS_NF_VOLUME_REBUILDING_PROGRESS	7	VDS_VOLUME_NOTIFICATION
Диск	VDS_NF_DISK_ARRIVE	8	VDS_DISK_NOTIFICATION
Диск	VDS_NF_DISK_DEPART	9	VDS_DISK_NOTIFICATION
Диск	VDS_NF_DISK_MODIFY	10	VDS_DISK_NOTIFICATION
Секция	VDS_NF_PARTITION_ARRIVE	11	VDS_PARTITION_NOTIFICATION
Секция	VDS_NF_PARTITION_DEPART	12	VDS_PARTITION_NOTIFICATION
Секция	VDS_NF_PARTITION_MODIFY	13	VDS_PARTITION_NOTIFICATION
Subsystem	VDS_NF_SUB_SYSTEM_ARRIVE	101	VDS_SUB_SYSTEM_NOTIFICATION
Subsystem	VDS_NF_SUB_SYSTEM_DEPART	102	VDS_SUB_SYSTEM_NOTIFICATION
Subsystem	VDS_NF_SUB_SYSTEM_MODIFY	151	VDS_SUB_SYSTEM_NOTIFICATION
Контроллер	VDS_NF_CONTROLLER_ARRIVE	103	VDS_CONTROLLER_NOTIFICATION
Контроллер	VDS_NF_CONTROLLER_DEPART	104	VDS_CONTROLLER_NOTIFICATION
Контроллер	VDS_NF_CONTROLLER_MODIFY	350	VDS_CONTROLLER_NOTIFICATION
Контроллер	VDS_NF_CONTROLLER_REMOVED	351	VDS_CONTROLLER_NOTIFICATION
Порт	VDS_NF_PORT_MODIFY	352	VDS_PORT_NOTIFICATION
Порт	VDS_NF_PORT_REMOVED	353	VDS_PORT_NOTIFICATION
Накопитель	VDS_NF_DRIVE_ARRIVE	105	VDS_DRIVE_NOTIFICATION
Накопитель	VDS_NF_DRIVE_DEPART	106	VDS_DRIVE_NOTIFICATION
Накопитель	VDS_NF_DRIVE_MODIFY	107	VDS_DRIVE_NOTIFICATION
Накопитель	VDS_NF_DRIVE_REMOVED	354	VDS_DRIVE_NOTIFICATION
LUN	VDS_NF_LUN_ARRIVE	108	VDS_LUN_NOTIFICATION
LUN	VDS_NF_LUN_DEPART	109	VDS_LUN_NOTIFICATION
LUN	VDS_NF_LUN_MODIFY	110	VDS_LUN_NOTIFICATION

 

VDS создает оставшиеся уведомления. В следующей таблице перечислены константы уведомлений на основе служб по категориям.

Категория	Уведомление	Значение	Ссылка на описание события
Диск	VDS_NF_DISK_ARRIVE	8	VDS_DISK_NOTIFICATION
Диск	VDS_NF_DISK_DEPART	9	VDS_DISK_NOTIFICATION
Диск	VDS_NF_DISK_MODIFY	10	VDS_DISK_NOTIFICATION
Буква диска	VDS_NF_DRIVE_LETTER_FREE	201	VDS_DRIVE_LETTER_NOTIFICATION
Буква диска	VDS_NF_DRIVE_LETTER_ASSIGN	202	VDS_DRIVE_LETTER_NOTIFICATION
Файловая система	VDS_NF_FILE_SYSTEM_MODIFY	203	VDS_FILE_SYSTEM_NOTIFICATION
Файловая система	VDS_NF_FILE_SYSTEM_FORMAT_PROGRESS	204	VDS_FILE_SYSTEM_NOTIFICATION
Громкость	VDS_NF_MOUNT_POINTS_CHANGE	205	VDS_MOUNT_POINT_NOTIFICATION

 

Связанные темы

Объектная модель VDS

IVdsAdviseSink

IVdsAdviseSink::OnNotify

IVdsProviderPrivate::OnLoad

IVdsService::Совет