ITuningSpace::get_DefaultLocator

 
Microsoft DirectShow 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.

Requirements

  Header: Dshow.h.

  Library: Quartz.dll.

See Also