DVDBuilder for .NET  3.4
DVD Authoring Software Development Kit
VRDevicePlugin Class Reference

This interface creates the video recording devices used by VideoRecorder. More...

Inheritance diagram for VRDevicePlugin:

Public Member Functions

VRDevice CreateFileSystemDevice (string path)
 Creates a File System device that can be added to the video recorder device list. More...
 
VRDevice CreateOpticalDiscDevice (char letter, bool exclusiveAccess)
 Creates an Optical Disc device that can be added to the video recorder device list. More...
 
VRDevice CreateOpticalDiscDevice (IntPtr handle)
 Creates an Optical Disc device that can be added to the video recorder device list. More...
 
void DisableTraceLog ()
 Disables the trace log. More...
 
void Dispose ()
 Disposes the VRDevicePlugin and reclaims the resources used by the object. More...
 
bool EnableTraceLog (string logFile, bool useExistingFile)
 Enables the trace log. More...
 

Properties

Int16 APIRevision [get]
 Returns the API revision (version) of the DVD VR device plugin. More...
 
ErrorInfo Error [get]
 The error information for the last operation. More...
 

Detailed Description

This interface creates the video recording devices used by VideoRecorder.

The recorder writes the DVD video to all devices in its device list. A VRDevicePlugin can be created through VideoRecorder.LoadDevicePlugin.

Version
2.0
See also
VideoRecorder.Devices, VideoRecorder.LoadDevicePlugin

Member Function Documentation

VRDevice CreateFileSystemDevice ( string  path)

Creates a File System device that can be added to the video recorder device list.

The device is created from a file system path.

Version
2.0
Parameters
pathFile system path.
Returns
An instance of a video recording device.
See also
VRDeviceType, VRDevice, VideoRecorder.Devices
VRDevice CreateOpticalDiscDevice ( char  letter,
bool  exclusiveAccess 
)

Creates an Optical Disc device that can be added to the video recorder device list.

The device is created either from a drive letter.

Version
2.0
Parameters
letterDrive letter.
exclusiveAccessIndicates whether exclusive access to the device is needed.
Returns
An instance of video recording device.
See also
VRDeviceType, VRDevice, VideoRecorder.Devices
VRDevice CreateOpticalDiscDevice ( IntPtr  handle)

Creates an Optical Disc device that can be added to the video recorder device list.

The device is created either from from an OS handle.

Version
2.0
Parameters
handleOS device handle
Returns
An instance of video recording device.
See also
VRDeviceType, VRDevice, VideoRecorder.Devices
void DisableTraceLog ( )

Disables the trace log.

void Dispose ( )

Disposes the VRDevicePlugin and reclaims the resources used by the object.

bool EnableTraceLog ( string  logFile,
bool  useExistingFile 
)

Enables the trace log.

The trace log is usefull for identifying errors or problems with particular devices.

Parameters
logFileFull path to the file that should be used to log messages.
useExistingFileIndicates whether an existing file should be used or a new log file should be created. Set this parameter to false to create a new empty log file or to true to use a file that already exists.
Returns
true Success. false if a log file cannot be created with the specified path.

Property Documentation

Int16 APIRevision
get

Returns the API revision (version) of the DVD VR device plugin.

The high order byte is the major version and the low order byte is the minor version of the API.

Version
2.0
ErrorInfo Error
get

The error information for the last operation.

See also
ErrorInfo