Edit

IMFPluginControl::GetPreferredClsidByIndex method (mfobjects.h)

  • Article

Gets a class identifier (CLSID) from the preferred list, specified by index value.

Syntax

HRESULT GetPreferredClsidByIndex(
  [in]  DWORD  pluginType,
  [in]  DWORD  index,
  [out] LPWSTR *selector,
  [out] CLSID  *clsid
);

Parameters

[in] pluginType

Member of the MF_Plugin_Type enumeration, specifying the type of object to enumerate.

[in] index

The zero-based index of the CLSID to retrieve.

[out] selector

Receives the key name associated with the CLSID. The caller must free the memory for the returned string by calling the CoTaskMemFree function. For more information about the format of key names, see the Remarks section of IMFPluginControl.

[out] clsid

Receives the CLSID at the specified index.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
 The method succeeded.
E_INVALIDARG
 Invalid argument.
HRESULT_FROM_WIN32(ERROR_NO_MORE_ITEMS)
 The index parameter is out of range.

Requirements

Requirement Value
Minimum supported client Windows 7 [desktop apps only]
Minimum supported server Windows Server 2008 R2 [desktop apps only]
Target Platform Windows
Header mfobjects.h (include Mfidl.h)

See also

IMFPluginControl