Fonction MFStartup (mfapi.h)

  • Article

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