Méthode IMFSinkWriter ::SetInputMediaType (mfreadwrite.h)

Article
02/28/2024

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

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
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 un changement 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 encodé.

Remarques

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

Une fois la diffusion en continu commencé, 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 mise à jour de la plateforme pour Windows Vista est installé.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Supplément windows 7, Windows Vista et mise à jour de la 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	Windows
En-tête	mfreadwrite.h

Voir aussi

IMFSinkWriter

Enregistreur récepteur

Partager via