Méthode IMFDeviceTransform::GetInputStreamPreferredState (mftransform.h)

Article
08/24/2023

La méthode GetInputStreamPreferredState obtient l’état et le type de média préférés d’un flux d’entrée MFT d’un appareil.

Syntaxe

HRESULT GetInputStreamPreferredState(
  [in]  DWORD             dwStreamID,
  [out] DeviceStreamState *value,
  [out] IMFMediaType      **ppMediaType
);

Paramètres

[in] dwStreamID

ID de flux du flux d’entrée dont l’état doit être récupéré.

[out] value

Spécifie le DeviceStreamState actuel du flux D’appareil MFT d’entrée spécifié.

[out] ppMediaType

Le type de média préféré pour le flux d’entrée est transmis via ce paramètre.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles incluent, sans s’y limiter, les valeurs indiquées dans le tableau suivant.

Code de retour	Description
S_OK	La transition de l’état du flux a réussi.
MF_E_INVALIDREQUEST	L’appareil MFT n’a pas pu prendre en charge la demande pour le moment.
MF_E_INVAILIDSTREAMNUMBER	Un ID de flux non valide a été transmis.
MF_E_INVALID_STREAM_STATE	La transition de flux demandée n’est pas possible.

Notes

Cette fonction d’interface permet d’interroger l’état et le médiatype préférés du flux d’entrée MFT de l’appareil vers lequel il doit être transféré.

Lorsqu’une modification du type de média du flux de sortie nécessite une modification correspondante dans l’entrée, l’appareil MFT publie METransformInputStreamStateChanged en DTM pour modifier le flux d’entrée approprié. DTM appelle GetInputStreamPreferredState pour récupérer le médiatype et l’état préférés du flux d’entrée MFT de l’appareil.

Par exemple, considérez un MFT d’appareil qui a deux flux d’entrée et trois flux de sortie. Laissez la source sortie 1 et sortie 2 à partir de l’entrée 1 et diffusez à 720p. Supposons maintenant que le type de média de Sortie 2 passe à 1080p. Pour répondre à cette demande, device MFT doit modifier le type de média Input 1 sur 1080p, en postant l’événement METransformInputStreamStateChanged dans la DTM. DTM appelle GetInputStreamPreferredState et récupère l’état et le médiatype préférés. DTM appelle SetInputStreamState pour modifier le médiatype et l’état du flux d’entrée.

Spécifications


Client minimal pris en charge	Windows 10 version 1703
Plateforme cible	Windows
En-tête	mftransform.h

Voir aussi

IMFDeviceTransform

Partager via