MFStartup-Funktion (mfapi.h)

Artikel
03/01/2024

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

Freigeben über