2.5.32 IDeckLinkNotification Interface

class IDeckLinkNotification

The IDeckLinkNotification interface is used to install or remove the callback for receiving DeckLink device notifications.

Related Interfaces

Interface	Interface ID	Description
IDeckLink	IID_IDeckLink	An IDeckLinkNotification object interface may be obtained from IDeckLink using QueryInterface
IDeckLinkNotificationCallback	IID_IDeckLinkNotificationCallback	An IDeckLinkNotificationCallback object interface is subscribed with IDeckLinkNotification::Subscribe()
IDeckLinkNotificationCallback	IID_IDeckLinkNotificationCallback	An IDeckLinkNotificationCallback object interface is unsubscribed with IDeckLinkNotification::Unsubscribe()

2.5.32.1 IDeckLinkNotification::Subscribe method

HRESULT IDeckLinkNotification::Subscribe(BMDNotifications topic, IDeckLinkNotificationCallback *theCallback);

The Subscribe method registers a callback object for a given topic.

Parameters:

• topic – The notification event type.

• theCallback – The callback object implementing the IDeckLinkNotificationCallback interface.

Return values:

• E_INVALIDARG – The callback parameter variable is NULL

• E_FAIL – Failure

• S_OK – Success

2.5.32.2 IDeckLinkNotification::Unsubscribe method

HRESULT IDeckLinkNotification::Unsubscribe(BMDNotifications topic, IDeckLinkNotificationCallback *theCallback);

The Unsubscribe method removes a notification event type from a callback object.

Parameters:

• topic – The notification event type.

• theCallback – The callback object implementing the IDeckLinkNotificationCallback interface.

Return values:

• E_INVALIDARG – The callback parameter variable is NULL

• E_FAIL – Failure

• S_OK – Success