2.5.31 IDeckLinkDeviceNotificationCallback Interface

The IDeckLinkDeviceNotificationCallback interface is a callback which is called when a DeckLink device arrives or is removed.

Related Interfaces

Interface

Interface ID

Description

IDeckLink

IID_IDeckLink

An IDeckLink object interface is passed to IDeckLinkDeviceNotificationCallback::DeckLinkDeviceRemoved()

IDeckLinkDiscovery

IID_IDeckLinkDiscovery

An IDeckLinkDeviceNotificationCallback object interface is installed with IDeckLinkDiscovery::InstallDeviceNotifications()

2.5.31.1 IDeckLinkDeviceNotificationCallback::DeckLinkDeviceArrived method

HRESULT IDeckLinkDeviceNotificationCallback::DeckLinkDeviceArrived(IDeckLink *deckLinkDevice);

The DeckLinkDeviceArrived method is called when a new DeckLink device becomes available. This method will be called on a private API thread.

This method is abstract in the base interface and must be implemented by the application developer. The result parameter (required by COM) is ignored by the caller.

Parameters:

deckLinkDevice – DeckLink device. The IDeckLink reference will be released when the callback returns. To hold on to it beyond the callback, call AddRef. Your application then owns the IDeckLink reference and is responsible for managing the IDeckLink object’s lifetime. The reference can be released at any time (including in the DeckLinkDeviceRemoved callback) by calling Release.

2.5.31.2 IDeckLinkDeviceNotificationCallback::DeckLinkDeviceRemoved method

HRESULT IDeckLinkDeviceNotificationCallback::DeckLinkDeviceRemoved(IDeckLink *deckLinkDevice);

The DeckLinkDeviceRemoved method is called when a DeckLink device is disconnected. This method will be called on a private API thread.

This method is abstract in the base interface and must be implemented by the application developer. The result parameter (required by COM) is ignored by the caller.

Parameters:

deckLinkDevice – DeckLink device.