IESFProperties::GetOutputFormatsList

HRESULT GetOutputFormatsList(
ULONG *pcElems,
GUID **ppElems
);

pcElems	[out] Pointer to a variable that receives the number of supported output formats (cElems).
ppElems	[out] Pointer to a table of GUIDs. The table is allocated by the filter. The caller must free this memory by calling CoTaskMemFree. The number of elements in the table is pointed to by cElems.

Retrieves a list of all supported output format values.

The GetOutputFormatsList method allocates the memory for the table of formats, which can vary in length. The caller of this method should free the memory (using CoTaskMemFree) when it is finished with it.

Example

GUID *pTable = NULL;
ULONG ulCount = 0;
hr = pESF->GetOutputFormatsList(&ulCount, &pTable);

if (SUCCEEDED(hr))
{

// Process list

/* ... */

  CoTaskMemFree(pTable);
}

Return Values

Returns an HRESULT value. Possible values include the following.

Return code	Description
S_OK	No error.
E_POINTER	At least one argument is not a valid pointer.
E_OUTOFMEMORY	The memory allocation failed.

Requirements

Header	ESFilter.h
Library	ESFilter.dll
MultiCam	5.0 or later