DVDBuilder for C++  3.4
DVD Authoring Software Development Kit
primo::dvdbuilder::VR::VideoRecorderError Namespace Reference

VideoRecorderError namespace. More...

Enumerations

enum  Enum {
  Start = 0x00000900,
  End = 0x000009FF,
  Success = 0,
  InternalError = 1,
  InvalidStructure = (VideoRecorderError::Start + 1),
  RecordingNotStarted = (VideoRecorderError::Start + 2),
  RecordingAlreadyStarted = (VideoRecorderError::Start + 3),
  MultiplexerError = (VideoRecorderError::Start + 4),
  InvalidVideoStreamCount = (VideoRecorderError::Start + 5),
  InvalidVideoCodec = (VideoRecorderError::Start + 6),
  InvalidVideoAspectRatio = (VideoRecorderError::Start + 7),
  InvalidVideoResolution = (VideoRecorderError::Start + 8),
  InvalidVideoFrameRate = (VideoRecorderError::Start + 9),
  InvalidAudioStreamCount = (VideoRecorderError::Start + 10),
  InvalidAudioSamplingFrequency = (VideoRecorderError::Start + 11),
  InvalidAudioCodec = (VideoRecorderError::Start + 12),
  InvalidAudioBitrate = (VideoRecorderError::Start + 13),
  DeviceError = (VideoRecorderError::Start + 14),
  DeviceNotSet = (VideoRecorderError::Start + 15),
  StartAsyncBufferFull = (VideoRecorderError::Start + 16),
  InvalidDeviceIndex = (VideoRecorderError::Start + 17)
}
 The VideoRecorderError::Enum type defines the possible errors returned by "VideoRecorder::error" when the error facility is VideoRecorder. More...
 

Detailed Description

VideoRecorderError namespace.

Version
2.0

Enumeration Type Documentation

enum Enum

The VideoRecorderError::Enum type defines the possible errors returned by "VideoRecorder::error" when the error facility is VideoRecorder.

Version
2.0
Enumerator
Start 

This is not an actual error code.

This is a base value for VideoRecorder errors.

Success 

Success.

InternalError 

Unexpected error in Video Recorder.

InvalidStructure 

Invalid DVD structure found in the IFO file on the disc.

RecordingNotStarted 

The recorder must be started in order to complete the required operation.

RecordingAlreadyStarted 

The recorder must be stopped in order to complete the required operation.

MultiplexerError 

The input MPEG-2 stream cannot be re-multiplexed.

InvalidVideoStreamCount 

The input stream must contain one video stream.

InvalidVideoCodec 

The input stream must be encoded in MPEG-2 format.

InvalidVideoAspectRatio 

The input video stream has invalid aspect ratio.

The valid aspect ratios are 4:3 | 16:9

InvalidVideoResolution 

The input video stream has invalid resolution.

The valid video resolutioins are:

NTSC: 720x480 | 704x480 | 352x480 | 352x240

PAL: 720x576 | 704x576 | 352x576 | 352x288

InvalidVideoFrameRate 

The input video stream has invalid frame rate.

The valid frame rates are 29.97 fsp (NTSC) and 25 fps (PAL).

InvalidAudioStreamCount 

The input MPEG-2 stream contains more than 8 audio streams.

InvalidAudioSamplingFrequency 

One or more input audio streams have invalid sampling frequency.

It must be either 48KHz or 96KHz.

InvalidAudioCodec 

One or more input audio streams are not in the expected format.

The valid audio codecs are: LPCM (16, 20, 24 bit), MPEG-1 Audio and AC-3 (Dolby Digital), DTS (Digital Theater System).

InvalidAudioBitrate 

One or more input audio streams have invalid bitrate.

The allowed max bitrates are:

LPCM: 6144 kbit/s

MPEG-1 Audio: 384 kbit/s

AC-3 (Dolby Digital): 448 kbit/s

DTS (Digital Theater System): 1536 kbit/s

DeviceError 

One or more of the devices used by the video recorder have failed after calling one of the following methods: VideoRecorder::prepareMedia , VideoRecorder::start , VideoRecorder::write , VideoRecorder::stop , and VideoRecorder::finalizeMedia .

In order to get a more detailed information enumerate the device error state using VideoRecorder::deviceError .

The device error state is reset and updated upon calling one of the following methods: VideoRecorder::prepareMedia , VideoRecorder::start and VideoRecorder::finalizeMedia .

When VideoRecorder::write is called any of the attached devices may fail and the error state is preserved until the Stop method is called. The failed devices are not used till the end of the recording. When the application gets a device error after calling VideoRecorder::write it may either stop the recording process or it may continue to write to the video recorder if at least one of the devices has a clean error state (ErrorInfo::facility is ErrorFacility::Success ).

When VideoRecorder::stop is called the video recorder tries to stop the devices with a clean error state and those that have run out of space. Their error state is updated. The other devices keep their error state.

See Error Handling

DeviceNotSet 

There's no device attached to the video recorder.

StartAsyncBufferFull 

The recording process has been started asyncronously using the StartAsync method and the video recorder cannot accept more data through the write() method.

Usually this is a sign that the media cannot be prepared for writing within certain time and the Stop method must be called to stop the recording. All data buffered in the video recorder is lost.

InvalidDeviceIndex 

The device index is not in the allowed range.

The specified index is not a valid index either in the device list or in the device error state list.

See also
VRDeviceList::item
VideoRecorder::titles
VideoRecorder::deviceError