Fonction MFStartup (mfapi.h)

Article
02/28/2024

Initialise Microsoft Media Foundation.

Syntaxe

HRESULT MFStartup(
  ULONG Version,
  DWORD dwFlags
);

Paramètres

Version

Numéro de version. Utilisez la valeur MF_VERSION, définie dans mfapi.h.

dwFlags

Ce paramètre est facultatif lors de l’utilisation de C++, mais obligatoire en C. La valeur doit être l’un des indicateurs suivants :

Valeur	Signification
MFSTARTUP_NOSOCKET	N’initialisez pas la bibliothèque de sockets.
MFSTARTUP_LITE	Équivalent à MFSTARTUP_NOSOCKET.
MFSTARTUP_FULL	Initialisez l’intégralité de la plateforme Media Foundation. Il s’agit de la valeur par défaut lorsque dwFlags n’est pas spécifié.

Valeur retournée

La fonction retourne un HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour	Description
S_OK	S_OK
MF_E_BAD_STARTUP_VERSION	Le paramètre Version nécessite une version plus récente de Media Foundation que la version en cours d’exécution.
MF_E_DISABLED_IN_SAFEMODE	La plateforme Media Foundation est désactivée, car le système a été démarré en « mode sans échec » (démarrage sans échec).
E_NOTIMPL	Media Foundation n’est pas implémenté sur le système. Cette erreur peut se produire si les composants multimédias ne sont pas présents (voir KB2703761 pour plus d’informations).

Remarques

Une application doit appeler cette fonction avant d’utiliser Media Foundation. Avant de quitter votre application, appelez MFShutdown une fois pour chaque appel précédent à MFStartup.

MFStartup doit être appelé pendant doit être appelé pendant l’initialisation de l’application et non à partir de constructeurs statiques pendant l’initialisation du processus.

N’appelez pas MFStartup ou MFShutdown à partir de threads de file d’attente de travail. Pour plus d’informations sur les files d’attente de travail, consultez Files d’attente de travail.

Cette fonction est disponible sur les plateformes suivantes si les composants redistribuables du SDK Windows Media Format 11 sont installés :

Windows XP avec Service Pack 2 (SP2) et versions ultérieures.
Windows XP Media Center Edition 2005 avec KB900325 (Windows XP Media Center Edition 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Media Center Edition) installés.

Exemples

    hr = MFStartup(MF_VERSION);

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	mfapi.h
Bibliothèque	Mfplat.lib
DLL	Mfplat.dll

Voir aussi

Initialisation de Media Foundation

Fonctions Media Foundation

Partager via