Méthode IMFSourceReaderEx ::SetNativeMediaType (mfreadwrite.h)

Article
02/28/2024

Définit le type de média natif d’un flux sur la source multimédia.

Syntaxe

HRESULT SetNativeMediaType(
  [in]  DWORD        dwStreamIndex,
  [in]  IMFMediaType *pMediaType,
  [out] DWORD        *pdwStreamFlags
);

Paramètres

[in] dwStreamIndex

[in] pMediaType

Pointeur vers l’interface IMFMediaType du type de média.

[out] pdwStreamFlags

Reçoit un OR au niveau du bit de zéro ou plus des indicateurs suivants.

Valeur	Signification
MF_SOURCE_READERF_ALLEFFECTSREMOVED	Tous les effets ont été supprimés du flux.
MF_SOURCE_READERF_CURRENTMEDIATYPECHANGED	Le type de sortie actuel a changé.

Valeur retournée

Cette méthode peut retourner l’une de ces valeurs.

Code de retour	Description
S_OK	Réussite.
MF_E_INVALIDREQUEST	Demande non valide.
MF_E_INVALIDSTREAMNUMBER	Le paramètre dwStreamIndex n’est pas valide.

Remarques

Cette méthode définit le type de sortie généré par la source multimédia. Contrairement à la méthode IMFSourceReader ::SetCurrentMediaType , cette méthode n’insère pas de décodeurs, de processeurs vidéo ou d’autres transformations. La source multimédia doit prendre en charge le type de média spécifié en mode natif. Pour obtenir la liste des types pris en charge à partir de la source multimédia, appelez IMFSourceReader ::GetNativeMediaType.

En mode asynchrone, cette méthode échoue si un exemple de demande est en attente. Dans ce cas, attendez que le rappel OnReadSample soit appelé avant d’appeler la méthode. Pour plus d’informations sur l’utilisation du lecteur source en mode asynchrone, consultez IMFSourceReader ::ReadSample.

Cette méthode peut déclencher une modification du format de sortie pour le flux. Si c’est le cas, l’indicateur MF_SOURCE_READERF_CURRENTMEDIATYPECHANGED est retourné dans le paramètre pdwStreamFlags . La méthode peut également entraîner la suppression de tous les effets ajoutés par la méthode IMFSourceReaderEx ::AddTransformForStream . Si cela se produit, l’indicateur MF_SOURCE_READERF_ALLEFFECTSREMOVED est retourné dans pdwStreamFlags.

Cette méthode est utile avec les appareils de capture audio et vidéo, car un appareil peut prendre en charge plusieurs formats de sortie. Cette méthode permet à l’application de choisir le format d’appareil avant l’ajout de décodeurs et d’autres transformations.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 8 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2012 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	mfreadwrite.h

Voir aussi

IMFSourceReaderEx

Partager via