2.6.5 IBMDStreamingVideoEncodingModePresetIterator Interface

The IBMDStreamingVideoEncodingModePresetIterator interface is used to enumerate the available preset video encoding modes.

A device may have a number of preset encoding modes. These are convenient encoding modes which can be used to encode video and audio into formats suitable for a number of commonly available playback devices.

A reference to an IBMDStreamingVideoEncodingModePresetIterator interface may be obtained from an IBMDStreamingDeviceInput interface using the GetVideoEncodingModePresetIterator method.

Related Interfaces

Interface

Interface ID

Description

IBMDStreamingVideoEncodingMode

IID_IBMDStreamingVideoEncodingMode

IBMDStreamingVideoEncodingModePresetIterator::Next() outputs an IBMDStreamingVideoEncodingMode object interface

IBMDStreamingDeviceInput

IID_IBMDStreamingDeviceInput

IBMDStreamingDeviceInput::GetVideoEncodingModePresetIterator() outputs an IBMDStreamingVideoEncodingModePresetIterator object interface

2.6.5.1 IBMDStreamingVideoEncodingModePresetIterator::Next method

HRESULT IBMDStreamingVideoEncodingModePresetIterator::Next(IBMDStreamingVideoEncodingMode **videoEncodingMode);

The Next method returns the next available IBMDStreamingVideoEncodingMode interface.

Parameters:

videoEncodingMode – IBMDStreamingVideoEncodingMode interface or NULL when no more video encoding modes are available.

Return values:

  • E_POINTER – The videoEncodingMode parameter is invalid.

  • S_FALSE – No (more) preset encoding modes are available.

  • S_OK – Success