IVdsAdviseSink interface

[Beginning with Windows 8 and Windows Server 2012, the Virtual Disk Service COM interface is superseded by the Windows Storage Management API.]

Receives VDS notifications.

When to implement

Applications implement this interface to receive notifications from VDS.

Providers do not implement this interface.

When to use

Hardware providers and software providers call the OnNotify method on this interface to send notifications to VDS. VDS calls the OnNotify method on the IVdsAdviseSink interface implemented by an application to forward notifications from providers to the application.

Members

The IVdsAdviseSink interface inherits from the IUnknown interface. IVdsAdviseSink also has these types of members:

Methods

The IVdsAdviseSink interface has these methods.

MethodDescription
OnNotify

Passes notifications from providers to VDS and from VDS to applications.

 

Remarks

VDS registers an IVdsAdviseSink interface with providers by calling the IVdsProviderPrivate::OnLoad method implemented by the provider.

After implementing the IVdsAdviseSink interface, an application must register the interface with VDS to receive notifications. To register, call the IVdsService::Advise method and pass a pointer to the IVdsAdviseSink interface. To unregister the IVdsAdviseSink interface and stop receiving notifications, use the IVdsService::Unadvise method.

Note  An application that calls Advise must eventually call Unadvise. Ideally, it should call Unadvise as soon as it no longer needs to receive notifications.
 

You do not specify a notification type or an object type when you register an application for notifications. Rather, you register to receive all VDS notifications of all types and from all providers.

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Vds.h;
VdsHwPrv.h (for hardware providers)

Library

Uuid.lib

See also

VDS Interfaces
IVdsProviderPrivate::OnLoad
IVdsService::Advise
VDS Notifications

 

 

Community Additions

ADD
Show: