Microsoft DirectX 8.0

SystemTuningSpaces Object

The SystemTuningSpaces Object contains a collection of all Tuning Spaces currently available on the local system and provides methods for adding new tuning spaces or removing existing ones.

Method or Property NameDescription
AddAdd a new Tuning Space to the collection. This tuning space will be persisted unless removed
CountNumber of items in the collection.
FindIDFind Local ID Number of the specified Tuning Space.
ItemFind the Tuning Space with the specified Index or update an existing tuning space in the collection.
MaxCountRetrieve the maximum number of items allowed in the collection.
RemoveRemove a Tuning Space from the collection. this tuning space will be deleted from the registry.
TuningSpacesForCLSIDReturns the collection of Tuning Spaces with the same implementation.
TuningSpacesForNameReturns the collection of Tuning Spaces matching the name.

SystemTuningSpaces.Add Method

SystemTuningSpaces Object

Add a new Tuning Space to the collection. This tuning space will be persisted unless removed.

Syntax

SystemTuningSpaces.Add(TuningSpace)

Parameters

TuningSpace The tuning space object to add (ATSCTuningSpace, DVBTuningSpace, etc.).

Return Value

If successful, returns the index of the newly-added object.

SystemTuningSpaces.Count Property

SystemTuningSpaces Object

Number of items in the collection.

Syntax

SystemTuningSpaces.Count

Remarks

This property is read only.

SystemTuningSpaces.FindID Method

SystemTuningSpaces Object

Find the local unique ID Number of the specified tuning space.

Syntax

SystemTuningSpaces.FindID(TuningSpace)

Parameters

TuningSpace The object whose ID you wish to retrieve.

Return Value

If successful, returns the ID of the specified object.

SystemTuningSpaces.Item Property

SystemTuningSpaces Object

Find the Tuning Space with the specified Index or update an existing tuning space in the collection.

Syntax

SystemTuningSpaces.Item(varIndex)

Parameters

varIndex The index of the tuning space object to set or retrieve.

Possible Values

Any valid tuning space object (ATSCTuningSpace, DVBTuningSpace, etc.)

Remarks

This property is read-write. Setting the Tuning Space object will persist the change to the backing store.

SystemTuningSpaces.MaxCount Property

SystemTuningSpaces Object

Retrieve the maximum number of items allowed in the collection.

Syntax

SystemTuningSpaces.MaxCount

Remarks

This property is read only from script. A C++ application can modify this value or it can also be modified in the registry.

SystemTuningSpaces.Remove Property

SystemTuningSpaces Object

Remove a Tuning Space from the collection. This tuning space will be deleted from the registry.

Syntax

SystemTuningSpaces.Remove

Remarks

This property is read-write.

SystemTuningSpaces.TuningSpacesForCLSID Method

SystemTuningSpaces Object

Returns the collection of Tuning Spaces with the same implementation.

Syntax

SystemTuningSpaces.TuningSpacesForCLSID(SpaceCLSID)

Parameters

SpaceCLSID The CLSID of the tuning spaces to search for.

Return Value

If successful, returns a SystemTuningSpaces object containing a collection of tuning space objects matching the CLSID.

SystemTuningSpaces.TuningSpacesForName Method

SystemTuningSpaces Object

Returns the collection of Tuning Spaces matching the name.

Syntax

SystemTuningSpaces.TuningSpacesForName(Name)

Parameters

Name The locally unique name of the Tuning Spaces to search for.

Return Value

If successful, returns a SystemTuningSpaces object containing the tuning spaces that match the specified name.