MFStartup-Funktion (mfapi.h)
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 |
|---|---|
|
Initialisieren Sie die Socketsbibliothek nicht. |
|
Entspricht MFSTARTUP_NOSOCKET. |
|
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 |
|---|---|
|
Die Methode wurde erfolgreich ausgeführt. |
|
Der Parameter Version erfordert eine neuere Version von Media Foundation als die ausgeführte Version. |
|
Die Media Foundation-Plattform ist deaktiviert, weil das System im "abgesicherten Modus" (fail-safe boot) gestartet wurde. |
|
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 |