Microsoft DirectX 9.0


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


HRESULT get_DefaultLocator(
    ILocator** 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.


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