Edit

IMFTopologyNode::GetOutputPrefType method (mfidl.h)

  • Article

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

Syntax

HRESULT GetOutputPrefType(
  [in]  DWORD        dwOutputIndex,
  [out] IMFMediaType **ppType
);

Parameters

[in] dwOutputIndex

Zero-based index of the output stream.

[out] 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

Requirement Value
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