Share via


Valid Combinations of Recording Elements

Click-to-record creates one-time, series, or manual recordings. Manual recordings are generated when the service and airing elements occur together (such as time, duration, and channel). All other valid combinations of elements result in a one-time or series recording depending on the isRecurring attribute.

Certain combinations of the program, service, and airing elements are not valid because they do not provide Windows Media Center with enough information to fulfill a recording request. For example, a click-to-record definition with only a service element is not valid unless there is a corresponding program or airing element.

The following table shows the valid combinations of the program, service, and airing elements.

Combination Description
program Record this program whenever it is on, and from any service that provides it.
program, service Record this program whenever it is on, but only from the specified service.
program, airing Record this program at the specified time and from any service.
program, service, airing Record this program at the specified time, and from the specified service.
service, airing Record the named service at the specified time.

For example, if the program element is specified, the fields are required to match based on the given criteria (such as the title, episode title, and release year) and on the match level (Exact, Contains, or StartsWith).

The service and airing elements, when provided, are more flexible. As with the program element, the given criteria must be met for these elements as well—if there is no match, the request is not fulfilled. However, to make the service and airing elements a preference rather than a requirement, you can specify the following, and then programs might be selected that do not match the given criteria:

  • For service: allowAlternateServices="true"
  • For airing: allowAlternateAirings="true"

See Also