MFLockPlatform-Funktion (mfapi.h)
Blockiert die MFShutdown-Funktion .
Syntax
HRESULT MFLockPlatform();
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 Funktion wurde erfolgreich ausgeführt. |
Hinweise
Diese Funktion verhindert, dass Arbeitswarteschlangenthreads heruntergefahren werden, wenn MFShutdown aufgerufen wird. Verwenden Sie diese Funktion, um sicherzustellen, dass asynchrone Vorgänge ordnungsgemäß abgeschlossen werden, bevor die Plattform heruntergefahren wird.
Diese Funktion enthält eine Sperre für die Media Foundation-Plattform. Rufen Sie MFUnlockPlatform auf, um die Plattform zu entsperren. Die Anwendung muss MFUnlockPlatform einmal für jeden Aufruf von MFLockPlatform aufrufen.
Die MFShutdown-Funktion blockiert, bis die Plattform entsperrt ist oder eine feste Wartezeit abgelaufen ist. (Die Wartezeit beträgt einige Sekunden.) Um Speicherverluste zu vermeiden, sollte die Anwendung die Plattform vor Ablauf der Wartezeit entsperren. Brechen Sie beispielsweise alle asynchronen Vorgänge ab, die auf den Abschluss warten und eine Sperre auf der Plattform halten.
Die Standardimplementierung der IMFAsyncResult-Schnittstelle sperrt die Media Foundation-Plattform automatisch, wenn das Ergebnisobjekt erstellt wird. Durch das Freigeben der Schnittstelle wird die Plattform entsperrt. Daher muss Ihre Anwendung in den meisten Fällen die Plattform nicht direkt sperren. Weitere Informationen 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.
Anforderungen
| 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 |