Share via

ITuningSpace::get_DefaultLocator Method

  • Article

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

Syntax

HRESULT get_DefaultLocator(
  [out]  ILocator **ppLocatorVal
);

Parameters

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

Return Value

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 Declared in Dshow.h.
DLL Requires Quartz.dll.

See Also

ITuningSpace Interface
ITuningSpace::put_DefaultLocator

Send comments about this topic to Microsoft

Build date: 12/4/2008