IMFSourceReaderEx ::SetNativeMediaType, méthode (mfreadwrite.h)

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 une OR au niveau du bit de zéro ou plus des indicateurs suivants.

Valeur retournée

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

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 requête 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 dans le format de sortie du flux. Dans ce cas, l’indicateur MF_SOURCE_READERF_CURRENTMEDIATYPECHANGED est retourné dans le paramètre pdwStreamFlags . La méthode peut également entraîner la suppression des 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 de l’appareil avant l’ajout de décodeurs et d’autres transformations.

Spécifications

Voir aussi

IMFSourceReaderEx