IMFTopologyNode::GetInputPrefType method (mfidl.h)
Retrieves the preferred media type for an input stream on this node.
HRESULT GetInputPrefType( [in] DWORD dwInputIndex, [out] IMFMediaType **ppType );
Zero-based index of the input stream.
Receives a pointer to the IMFMediaType interface of the media type. The caller must release the interface.
The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.
||The method succeeded.|
||This node does not have a preferred input type.|
||Invalid stream index.|
||This node is a source node.|
Source nodes cannot have inputs. If this method is called on a source node, it returns E_NOTIMPL.
The preferred input 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 input 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.)
|Minimum supported client||Windows Vista [desktop apps only]|
|Minimum supported server||Windows Server 2008 [desktop apps only]|