2.5.30 IDeckLinkDiscovery Interface

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

A reference to an IDeckLinkDiscovery interface may be obtained from CoCreateInstance() on platforms with native COM support or from CreateDeckLinkDiscoveryInstance() on other platforms.

Related Interfaces

Interface

Interface ID

Description

IDeckLinkDeviceNotificationCallback

IID_IDeckLinkDeviceNotificationCallback

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

2.5.30.1 IDeckLinkDiscovery::InstallDeviceNotifications method

HRESULT IDeckLinkDiscovery::InstallDeviceNotifications(IDeckLinkDeviceNotificationCallback *deviceNotificationCallback);

The InstallDeviceNotifications method installs the IDeckLinkDeviceNotificationCallback callback which will be called when a new DeckLink device becomes available.

Parameters:

deviceNotificationCallback – Callback object implementing the IDeckLinkDeviceNotificationCallback interface.

Return values:

  • E_INVALIDARG – The parameter variable is NULL

  • E_FAIL – Failure

  • S_OK – Success

2.5.30.2 IDeckLinkDiscovery::UninstallDeviceNotifications method

HRESULT IDeckLinkDiscovery::UninstallDeviceNotifications();

The UninstallDeviceNotifications method removes the DeckLink device notifications callback. When this method returns, it guarantees there are no ongoing callbacks to the IDeckLinkDeviceNotificationCallback instance.

Return values:

  • E_FAIL – Failure

  • S_OK – Success