2.6.1 IBMDStreamingDiscovery Interface

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

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

Related Interfaces

Interface

Interface ID

Description

IBMDStreamingDeviceNotificationCallback

IID_IBMDStreamingDeviceNotificationCallback

An IBMDStreamingDeviceNotificationCallback object interface is installed with IBMDStreamingDiscovery::InstallDeviceNotifications()

2.6.1.1 IBMDStreamingDiscovery::InstallDeviceNotifications method

HRESULT IBMDStreamingDiscovery::InstallDeviceNotifications(IBMDStreamingDeviceNotificationCallback *theCallback);

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

Note

Only one callback may be installed at a time.

Parameters:

theCallback – Callback object implementing the IBMDStreamingDeviceNotificationCallback interface

Return values:

  • E_INVALIDARG – The callback parameter is invalid.

  • E_UNEXPECTED – An unexpected internal error has occurred.

  • E_FAIL – Failure

  • S_OK – Success

2.6.1.2 IBMDStreamingDiscovery::UninstallDeviceNotifications method

HRESULT IBMDStreamingDiscovery::UninstallDeviceNotifications();

The UninstallDeviceNotifications method removes the device notifications callback.

Return values:

  • E_UNEXPECTED – An unexpected internal error has occurred.

  • S_OK – Success