Partager via


Fonction MFLockPlatform (mfapi.h)

Bloque la fonction MFShutdown .

Syntaxe

HRESULT MFLockPlatform();

Valeur de retour

La fonction retourne un HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code de retour Description
S_OK
La fonction a réussi.

Notes

Cette fonction empêche l’arrêt des threads de file d’attente de travail lors de l’appel de MFShutdown . Utilisez cette fonction pour vous assurer que les opérations asynchrones se terminent correctement avant l’arrêt de la plateforme.

Cette fonction contient un verrou sur la plateforme Media Foundation. Pour déverrouiller la plateforme, appelez MFUnlockPlatform. L’application doit appeler MFUnlockPlatform une fois pour chaque appel à MFLockPlatform.

La fonction MFShutdown se bloque jusqu’à ce que la plateforme soit déverrouillée ou jusqu’à ce qu’une période d’attente fixe soit écoulée. (La période d’attente est de quelques secondes.) Pour éviter les fuites de mémoire, l’application doit déverrouiller la plateforme avant la fin de la période d’attente. Par exemple, annulez toutes les opérations asynchrones qui attendent de se terminer et qui détiennent un verrou sur la plateforme.

L’implémentation par défaut de l’interface IMFAsyncResult verrouille automatiquement la plateforme Media Foundation lors de la création de l’objet de résultat. La libération de l’interface déverrouille la plateforme. Par conséquent, dans la plupart des cas, votre application n’a pas besoin de verrouiller directement la plateforme. Pour plus d’informations, consultez Files d’attente de travail.

Cette fonction est disponible sur les plateformes suivantes si les composants redistribuables du SDK Windows Media Format 11 sont installés :

  • Windows XP avec Service Pack 2 (SP2) et versions ultérieures.
  • Windows XP Media Center Edition 2005 avec KB900325 (Windows XP Media Center Edition 2005) et KB925766 (correctif cumulatif d’octobre 2006 pour Windows XP Media Center Edition) installés.

Spécifications

   
Client minimal pris en charge Windows Vista [applications de bureau | applications UWP]
Serveur minimal pris en charge Windows Server 2008 [applications de bureau | applications UWP]
Plateforme cible Windows
En-tête mfapi.h
Bibliothèque Mfplat.lib
DLL Mfplat.dll

Voir aussi

Fonctions Media Foundation

API de plateforme Media Foundation

Files d’attente de travail