Scheduling Recorded TV with Click-To-Record

  • Article

Click-to-record is a feature that enables applications to programmatically schedule the recording of TV programs. Click-to-record can be invoked in the following ways:

  • By a Windows Media Center application running inside the Windows Media Center shell.
  • By an external application using the managed click-to-record application programming interface (API).
  • By the user launching a click-to-record document from the Windows shell.

Each method of invoking click-to-record involves passing Extensible Markup Language (XML) markup to Windows Media Center. The XML defines the criteria that Windows Media Center uses to locate, schedule, and record the TV programs. This documentation assumes that you are already familiar with XML in general and XML schemas in particular. For more information, see XML Developer Center on the MSDN web site.

Note   The click-to-record API (the Microsoft.MediaCenter.TV.Epg and Microsoft.MediaCenter.TV.Scheduling namespaces) are supported on x86 and AMD64 platforms, but are not supported when called from 32-bit applications that are running in a 32-bit emulator on an AMD64 platform (also known as WOW64). If your application is a combination of managed and unmanaged code, you must compile two versions to support both platforms. If your code is entirely managed, it is platform neutral and the compiled binary can be run on both x86 and AMD64 platforms.

This section describes the XML schema that supports the Windows Media Center click-to-record feature and describes the XML elements used specify TV programs for Windows Media Center to record. This section discusses the following topics.

Topic Description
XML Documents for Click-To-Record Describes how to create XML documents for submitting TV recording requests to Windows Media Center.
Types of Recording Requests Describes the various types of TV recording requests that Windows Media Center recognizes.
Valid Combinations of Recording Elements Describes the combinations of XML elements that Windows Media Center interprets as valid TV recording requests.
Sample Click-To-Record XML Document Provides a sample XML document that shows how to use the click-to-record elements to create a TV recording request.
Invoking the Click-To-Record Feature Describes the ways in which TV recording requests can be submitted to Windows Media Center.
Creating a Click-To-Record Request with the CreateScheduleRequest Method Describes how to create XML documents using the click-to-record API.

See Also