Fonction MFGetTopoNodeCurrentType (mfidl.h)

Article
08/24/2023

Obtient le type de média d’un flux associé à un nœud de topologie.

Syntaxe

HRESULT MFGetTopoNodeCurrentType(
        IMFTopologyNode *pNode,
        DWORD           dwStreamIndex,
        BOOL            fOutput,
  [out] IMFMediaType    **ppType
);

Paramètres

pNode

Pointeur vers l’interface IMFTopologyNode .

dwStreamIndex

Identificateur du flux à interroger. Ce paramètre est interprété comme suit :

Nœuds de transformation : la valeur est l’index de base zéro du flux d’entrée ou de sortie.
Tous les autres types de nœuds : la valeur doit être égale à zéro.

fOutput

Si la valeur EST TRUE, la fonction obtient un type de sortie. Si la valeur est FALSE, la fonction obtient un type d’entrée. Ce paramètre est interprété comme suit :

Nœuds de sortie : la valeur doit être TRUE.
Nœuds sources : la valeur doit être FALSE.
Nœuds tee : la valeur est ignorée.
Transformer les nœuds : si la valeur est TRUE, le paramètre dwStreamIndex est l’index d’un flux de sortie. Sinon, dwStreamIndex est l’index d’un flux d’entrée.

[out] ppType

Reçoit un pointeur vers l’interface IMFMediaType . L’appelant doit libérer l’interface.

Valeur retournée

La fonction retourne un HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
MF_E_INVALIDSTREAMNUMBER	L’index de flux n’est pas valide.

Notes

Cette fonction obtient le type de média réel à partir de l’objet associé au nœud de topologie. Le paramètre pNode doit spécifier un nœud qui appartient à une topologie entièrement résolue. Si le nœud appartient à une topologie partielle, la fonction échouera probablement.

Les nœuds tee n’ont pas d’objet associé à interroger. Pour les nœuds de départ, la fonction obtient le type d’entrée du nœud, s’il est disponible. Sinon, si aucun type d’entrée n’est disponible, la fonction obtient le type de média du flux de sortie principal du nœud. Le flux de sortie principal est identifié par l’attribut MF_TOPONODE_PRIMARYOUTPUT .

Configuration requise


Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mfidl.h
Bibliothèque	Mf.lib
DLL	Mf.dll

Voir aussi

Fonctions Media Foundation

Partager via