Microsoft DirectX 9.0

ITuningSpace::get_DefaultLocator

The get_DefaultLocator method retrieves the default locator for this tuning space.

Syntax

HRESULT get_DefaultLocator(
    ILocator** ppLocatorVal
    );

Parameters

ppLocatorVal

[out]  Address of a variable that receives a pointer to ILocator interface. The caller must release the interface.

Return Values

Returns S_OK if successful. If the method fails, error information can be retrieved using the standard COM IErrorInfo interface.

Remarks

The tuning space might not have a default locator.  It is the application's responsibility to provide a default locator for the tuning space if needed.

If the tuning space does not have a default locator, this method succeeds but returns the value NULL in the ppLocatorVal parameter. Check for a NULL value before attempting to dereference the pointer.

See Also