IMFTopologyNode::GetOutputPrefType method

Retrieves the preferred media type for an output stream on this node.

Syntax

HRESULT GetOutputPrefType(
  DWORD        dwOutputIndex,
  IMFMediaType **ppType
);

Parameters

dwOutputIndex

Zero-based index of the output stream.

ppType

Receives a pointer to the IMFMediaType interface of the media type. The caller must release the interface.

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_FAIL
This node does not have a preferred output type.
E_INVALIDARG
Invalid stream index.
E_NOTIMPL
This node is an output node.

Remarks

Output nodes cannot have outputs. If this method is called on an output node, it returns E_NOTIMPL.

The preferred output type provides a hint to the topology loader. In a fully resolved topology, there is no guarantee that every topology node will have a preferred output type. To get the actual media type for a node, you must get a pointer to the node's underlying object. (For more information, see MF_TOPOLOGY_TYPE enumeration.)

Requirements

   
Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header mfidl.h
Library Mfuuid.lib

See Also

IMFTopologyNode

Topologies