Microsoft DirectX 8.0

ITuningSpaces Interface

This interface is implemented on the SystemTuningSpaces object and provides methods to retrieve the tuning spaces available on the host system.

MethodNameDescription
get_CountReturns the number of tuning spaces in the collection.
get_EnumTuningSpacesConvenience function so C++ applications don't have to unpack a VARIANT datatype.
get_ItemReturns the specified item in the collection.
get__NewEnumHelper method for Visual Basic and script applications. Not used in C++.

ITuningSpaces::get_Count

ITuningSpaces Interface

Returns the number of tuning spaces in the collection.

Syntax

HRESULT get_Count(
    long* Count
    );

Parameters

Count
[out, retval] Pointer to a variable of type long that receives the number of items in the collection.

Return Value

Returns S_OK if successful.

ITuningSpaces::get_EnumTuningSpaces

ITuningSpaces Interface

Convenience function so C++ applications don't have to unpack a VARIANT datatype.

Syntax

HRESULT get_EnumTuningSpaces(
    IEnumTuningSpaces** NewEnum
    );

Parameters

NewEnum
[out, retval] Address of an IEnumTuningSpaces interface pointer that receives the new collection.

Return Value

Returns S_OK if successful.

ITuningSpaces::get_Item

ITuningSpaces Interface

Returns the specified item in the collection.

Syntax

HRESULT get_Item(
    VARIANT varIndex,
    ITuningSpace** TuningSpace
    );

Parameters

varIndex
[in] String or index number that specifies the item to return.
TuningSpace
[out, retval] Address of the returned ITuningSpace interface pointer.

Return Value

Returns S_OK if successful.

ITuningSpaces::get__NewEnum

ITuningSpaces Interface

Helper method for Visual Basic and script applications. Not used in C++.

Syntax

HRESULT get__NewEnum(
    IEnumVARIANT** NewEnum
    );

Parameters

NewEnum
[out, retval] Address of an IEnumVariant interface pointer.

Return Value

Returns S_OK if successful.

Remarks

This method enables Microsoft® Visual Basic® and script applications to retrieve items in a For...Next loop.