MFStartup-Funktion (mfapi.h)

  • Artikel

Initialisiert Microsoft Media Foundation.

Syntax

HRESULT MFStartup(
  ULONG Version,
  DWORD dwFlags
);

Parameter

Version

Versionsnummer: Verwenden Sie den Wert MF_VERSION, der in mfapi.h definiert ist.

dwFlags

Dieser Parameter ist bei Verwendung von C++ optional, aber in C erforderlich. Der Wert muss eines der folgenden Flags sein:

Wert Bedeutung
MFSTARTUP_NOSOCKET
 Initialisieren Sie die Socketsbibliothek nicht.
MFSTARTUP_LITE
 Entspricht MFSTARTUP_NOSOCKET.
MFSTARTUP_FULL
 Initialisieren Sie die gesamte Media Foundation-Plattform. Dies ist der Standardwert, wenn dwFlags nicht angegeben ist.

Rückgabewert

Die Funktion gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode BESCHREIBUNG
S_OK
 Die Methode wurde erfolgreich ausgeführt.
MF_E_BAD_STARTUP_VERSION
 Der Parameter Version erfordert eine neuere Version von Media Foundation als die ausgeführte Version.
MF_E_DISABLED_IN_SAFEMODE
 Die Media Foundation-Plattform ist deaktiviert, weil das System im "abgesicherten Modus" (fail-safe boot) gestartet wurde.
E_NOTIMPL
 Media Foundation ist nicht im System implementiert. Dieser Fehler kann auftreten, wenn die Medienkomponenten nicht vorhanden sind (weitere Informationen finden Sie unter KB2703761 ).

Hinweise

Eine Anwendung muss diese Funktion aufrufen, bevor Media Foundation verwendet wird. Bevor Ihre Anwendung beendet wird, rufen Sie MFShutdown einmal für jeden vorherigen Aufruf von MFStartup auf.

MFStartup sollte während der App-Initialisierung aufgerufen werden und nicht von statischen Konstruktoren während der Prozessinitialisierung.

Rufen Sie MFStartup oder MFShutdown nicht aus Arbeitswarteschlangenthreads auf. Weitere Informationen zu Arbeitswarteschlangen finden Sie unter Arbeitswarteschlangen.

Diese Funktion ist auf den folgenden Plattformen verfügbar, wenn die verteilbaren Komponenten des Windows Media Format 11 SDK installiert sind:

  • Windows XP mit Service Pack 2 (SP2) und höher.
  • Windows XP Media Center Edition 2005 mit KB900325 (Windows XP Media Center Edition 2005) und KB925766 (Updaterollup für Windows XP Media Center Edition) vom Oktober 2006) installiert.

Beispiele

    hr = MFStartup(MF_VERSION);

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile mfapi.h
Bibliothek Mfplat.lib
DLL Mfplat.dll

Weitere Informationen

Initialisieren von Media Foundation

Media Foundation-Funktionen