Table of Contents

Class AdditionalStreamFailedEventArgs

Namespace
VisioForge.Core.Types.X.Events
Assembly
VisioForge.Core.dll

Event arguments raised when an additional audio stream registered via MediaPlayerCoreX.Audio_AdditionalStreams_Add fails to build during pipeline construction. The main pipeline continues without the failed stream; this event is the programmatic signal so callers don't have to correlate log messages to diagnose why a stream is missing from the mix.

public class AdditionalStreamFailedEventArgs : EventArgs

Inheritance

Inherited Members

Constructors

AdditionalStreamFailedEventArgs(int, Type, Exception, string)

Initializes a new instance of the VisioForge.Core.Types.X.Events.AdditionalStreamFailedEventArgs class.

public AdditionalStreamFailedEventArgs(int index, Type settingsType, Exception exception, string reason = null)

Parameters

index int

Zero-based index of the failed stream.

settingsType Type

Runtime type of the settings object, or null.

exception Exception

Exception that caused the failure, or null.

reason string

Optional explicit reason string; if null the exception message is used.

Properties

Exception

Gets the exception (if any) that caused the failure. null when the failure was surfaced without a throw (for example, CreateSourceBlock returned null).

public Exception Exception { get; }

Property Value

Exception

Index

Gets the zero-based index of the failed stream in the additional-streams list, as registered at Audio_AdditionalStreams_Add time.

public int Index { get; }

Property Value

int

Reason

Gets a short human-readable reason for the failure. Always populated — either the exception's message or a static reason string.

public string Reason { get; }

Property Value

string

SettingsType

Gets the runtime type of the source-settings object that was registered, if known. May be null if the settings reference itself was null at failure time.

public Type SettingsType { get; }

Property Value

Type