Windows XP Media Center Edition SDK CD/DVD Recording Reference
.jpg) |
| Previous | Next |
CD/DVD Recording Reference
The Media Center add-in object model provides the following application programming interface elements to support CD/DVD recording add-ins.
The CD/DVD recording types are in two managed namespaces:
- Microsoft.MediaCenter.AddIn.DiscWriter
- Microsoft.MediaCenter.AddIn.ListMaker
Microsoft.MediaCenter.AddIn.DiscWriter Namespace
The following types are in the Microsoft.MediaCenter.AddIn.DiscWriter namespace, which is in the microsoft.mediacenter.dll assembly.
The Microsoft.MediaCenter.AddIn.DiscWriter namespace exposes the following interface.
| Interface | Description |
| DiscWriter | Enables the exchange of disc-related information between Media Center and a CD/DVD recording add-in. |
The Microsoft.MediaCenter.AddIn.DiscWriter namespace defines the following enumeration type.
| Enumeration type | Description |
| DiscFormat | Defines the disc recording formats that a CD/DVD recording add-in supports. |
The Microsoft.MediaCenter.AddIn.DiscWriter namespace defines the following exceptions.
| Exception | Description |
| AppendNotSupportedListMakerException | Contains information about an exception raised because the CD/DVD recording add-in does not support appending files to the current medium. |
| DiscSpaceListMakerException | Contains information about an exception raised by a CD/DVD recording add-in, indicating that the amount of available disc space is not adequate to complete the recording operation. |
| FitToDiscListMakerException | Contains information about an exception raised by a CD/DVD recording add-in, indicating that an error occurred during a recording operation in which the fit-to-disc feature is being used. |
| NoMediaListMakerException | Contains information about an exception raised by a CD/DVD recording add-in, indicating that the recording device contains no recording medium. |
| WrongMediaTypeListMakerException | Contains information about an exception raised by a CD/DVD recording add-in, indicating that the add-in does not support the specified type of recording medium. |
Microsoft.MediaCenter.AddIn.ListMaker Namespace
The following types are in the Microsoft.MediaCenter.AddIn.ListMaker namespace, which is in the microsoft.mediacenter.dll assembly.
The Microsoft.MediaCenter.AddIn.ListMaker namespace exposes the following interfaces.
| Interface | Description |
| IBrandInfo | Enables a CD/DVD recording add-in to customize the list-making portion of the Media Center user interface. |
| ListMakerApp | Enables a CD/DVD recording add-in to receive user-created lists of files from Media Center. |
| ListMakerItem | Enables a CD/DVD recording add-in to access individual items from a list of files provided by Media Center. |
| ListMakerList | Enables a CD/DVD recording add-in to access a collection of list items provided by Media Center. |
The Microsoft.MediaCenter.AddIn.ListMaker namespace defines the following enumeration types.
| Enumeration type | Description |
| MediaType | Defines the types of media that a CD/DVD recording add-in can support. |
| ProgressType | Defines how Media Center should interpret the progress reported by a CD/DVD recording add-in. |
| StatusFormat | Defines the format in which the CD/DVD recording add-in provides status information. |
The Microsoft.MediaCenter.AddIn.ListMaker namespace exposes the following delegates and event arguments.
| Delegate or event argument | Description |
| CompletionEventHandler | Handles completion events from CD/DVD recording add-ins. |
| ProgressChangedEventArgs | Contains information about the progress of a CD/DVD recording operation. |
| ProgressChangedEventHandler | Handles progress updates from CD/DVD recording add-ins. |
The Microsoft.MediaCenter.AddIn.ListMaker namespace defines the following exceptions.
| Exception | Description |
| CGMSNoRightsListMakerException | Contains information about an exception raised because an attempt was made to copy broadcast media content protected by Copy General Management System Analog (CGMS-A). |
| DeviceInUseListMakerException | Contains information about an exception raised because another process is using the required recording device. |
| DRMNoRightsListMakerException | Contains information about an exception raised because an attempt was made to copy DRM-protected content, but the user has not been granted the right to copy the content. |
| FileAlreadyExistsListMakerException | Contains information about an exception raised because the file list contains a duplicate file. |
| FileCorruptListMakerException | Contains information about an exception raised because a file contains corrupted data. |
| FileNotFoundListMakerException | Contains information about an exception raised because a file could not be located. |
| InstallationListMakerException | Contains information about an exception raised because of problems with the installation of the add-in. |
| ListMakerException | Contains information about an exception raised by a CD/DVD recording add-in while processing files from Media Center. |
| NoDeviceListMakerException | Contains information about an exception raised because no recording device exists. |
| NotEnoughDiskForStashListMakerException | Contains information about an exception raised because the hard disk does not have enough space available to store temporary files. |
| UnSupportedFileListMakerException | Contains information about an exception raised by a CD recording add-in, indicating that the file is corrupted or is in an unsupported file format. |
| UserAbortListMakerException | Contains information about an exception raised because the user ended a recording operation before it was finished. |
See Also
| Previous | Next |