Microsoft DirectX 8.1 (C++)

Service Object

This topic applies to Windows XP Home Edition and Windows XP Professional only.

A Service object represents a thing, such as an analog TV broadcast, DVB-S broadcast, or FM radio station. Tuning information, called a tune request, is part of the Service object. A tune request has the details necessary to tune to the service. The tune request may contain the frequency of the broadcast or channel. This tune request can be extracted from the Service object and passed to a tuning device, such as a video card, which then performs the actual tuning. A Service object also contains information about the service provider consisting of the provider name, the provider network affiliation, and the provider description.

There is also a Services object for managing a collection of Service objects.

Service objects may have an associated name. This association is a Channel object.

A Service object can have metaproperties, which are represented by a MetaPropertiescollection of MetaProperty objects.

This object exposes the following properties.

Property Description
EndTime Specifies and retrieves the end time of the service.
ID Retrieves the unique identifier for this Service object.
MetaProperties Retrieves the MetaProperties object associated with this Service object.
ProviderDescription Specifies and retrieves the provider description of the service.
ProviderName Specifies and retrieves the provider name of the service.
ProviderNetworkName Retrieves the provider network name of the service.
ScheduleEntries Retrieves a collection of all ScheduleEntry objects that contain this Service object.
StartTime Specifies and retrieves the start time of the service.
TuneRequest Specifies and retrieves a TuneRequest object associated with the Service object.