Partager via


IMFSinkWriter ::SetInputMediaType, méthode (mfreadwrite.h)

Définit le format d’entrée d’un flux sur l’enregistreur récepteur.

Syntaxe

HRESULT SetInputMediaType(
  [in] DWORD         dwStreamIndex,
  [in] IMFMediaType  *pInputMediaType,
  [in] IMFAttributes *pEncodingParameters
);

Paramètres

[in] dwStreamIndex

Index de base zéro du flux. L’index est reçu par le paramètre pdwStreamIndex de la méthode IMFSinkWriter ::AddStream .

[in] pInputMediaType

Pointeur vers l’interface IMFMediaType d’un type multimédia. Le type de média spécifie le format d’entrée.

[in] pEncodingParameters

Pointeur vers l’interface IMFAttributes d’un magasin d’attributs. Utilisez le magasin d’attributs pour configurer l’encodeur. Ce paramètre peut être NULL.

Valeur retournée

La méthode retourne un HRESULT. Les valeurs possibles incluent, mais ne sont pas limitées à celles du tableau suivant.

Code de retour Descriptif
S_OK
S_OK
MF_E_INVALIDMEDIATYPE
Le récepteur multimédia sous-jacent ne prend pas en charge le format, aucune conversion n’est possible, ou une modification de format dynamique n’est pas possible.
MF_E_INVALIDSTREAMNUMBER
Le paramètre dwStreamIndex n’est pas valide.
MF_E_TOPO_CODEC_NOT_FOUND
Impossible de trouver un encodeur pour le format codé.

Remarques

Le format d’entrée n’a pas besoin de correspondre au format cible écrit dans le récepteur multimédia. Si les formats ne correspondent pas, la méthode tente de charger un encodeur qui peut encoder du format d’entrée au format cible.

Une fois la diffusion en continu commencée, c’est-à-dire après le premier appel à IMFSinkWriter ::WriteSample, vous pouvez appeler cette méthode à tout moment pour modifier le format d’entrée. Toutefois, l’encodeur sous-jacent et le récepteur multimédia doivent prendre en charge les modifications de format dynamique.

Cette interface est disponible sur Windows Vista si le supplément de mise à jour de plateforme pour Windows Vista est installé.

Spécifications

Requirement Valeur
Client minimum requis Supplément Windows 7, Windows Vista et Mise à jour de plateforme pour Windows Vista [applications de bureau | Applications UWP]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau | Applications UWP]
plateforme cible Fenêtres
Header mfreadwrite.h

Voir aussi

IMFSinkWriter

Enregistreur récepteur