MFLockPlatform-Funktion (mfapi.h)

  • Artikel

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
S_OK
 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

Weitere Informationen

Media Foundation-Funktionen

Media Foundation Platform-APIs

Arbeitswarteschlangen