IMFTopologyNode::GetInputPrefType method (mfidl.h)
Retrieves the preferred media type for an input stream on this node.
Syntax
HRESULT GetInputPrefType(
[in] DWORD dwInputIndex,
[out] IMFMediaType **ppType
);
Parameters
[in] dwInputIndex
Zero-based index of the input 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 |
---|---|
|
The method succeeded. |
|
This node does not have a preferred input type. |
|
Invalid stream index. |
|
This node is a source node. |
Remarks
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.)
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 |