2.5.1 IDeckLinkIterator Interface

The IDeckLinkIterator interface is used to enumerate the available DeckLink devices.

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

The IDeckLink interface(s) returned may be used to access the related interfaces which provide access to the core API functionality.

Related Interfaces

Interface

Interface ID

Description

IDeckLink

IID_IDeckLink

IDeckLinkIterator::Next() outputs an IDeckLink object interface

2.5.1.1 IDeckLinkIterator::Next method

HRESULT IDeckLinkIterator::Next(IDeckLink **deckLinkInstance);

The Next method creates an object representing a physical DeckLink device and assigns the address of the IDeckLink interface of the newly created object to the decklinkInstance parameter.

Parameters:

deckLinkInstance – The next IDeckLink interface

Return values:

  • E_FAIL – Failure

  • S_FALSE – No (more) devices found

  • S_OK – Success