Función MFLockPlatform (mfapi.h)

  • Artículo

Bloquea la función MFShutdown .

Sintaxis

HRESULT MFLockPlatform();

Valor devuelto

La función devuelve un VALOR HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código devuelto Descripción
S_OK
 La función se ha realizado correctamente.

Comentarios

Esta función impide que los subprocesos de cola de trabajo se apaguen cuando se llama a MFShutdown . Use esta función para asegurarse de que las operaciones asincrónicas se completen correctamente antes de que se cierre la plataforma.

Esta función contiene un bloqueo en la plataforma media Foundation. Para desbloquear la plataforma, llame a MFUnlockPlatform. La aplicación debe llamar a MFUnlockPlatform una vez para cada llamada a MFLockPlatform.

La función MFShutdown se bloquea hasta que se desbloquea la plataforma o hasta que haya transcurrido un período de espera fijo. (El período de espera es de unos segundos). Para evitar pérdidas de memoria, la aplicación debe desbloquear la plataforma antes de que finalice el período de espera. Por ejemplo, cancele las operaciones asincrónicas que estén esperando completarse y mantenga un bloqueo en la plataforma.

La implementación predeterminada de la interfaz IMFAsyncResult bloquea automáticamente la plataforma Media Foundation cuando se crea el objeto de resultado. La liberación de la interfaz desbloquea la plataforma. Por lo tanto, en la mayoría de los casos, la aplicación no necesita bloquear la plataforma directamente. Para obtener más información, vea Colas de trabajo.

Esta función está disponible en las siguientes plataformas si se instalan los componentes redistribuibles del SDK de Windows Media Format 11:

  • Windows XP con Service Pack 2 (SP2) y versiones posteriores.
  • Windows XP Media Center Edition 2005 con KB900325 (Windows XP Media Center Edition 2005) y KB925766 (paquete acumulativo de actualizaciones de octubre de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

   
Cliente mínimo compatible Windows Vista [aplicaciones de escritorio | aplicaciones para UWP]
Servidor mínimo compatible Windows Server 2008 [aplicaciones de escritorio | aplicaciones para UWP]
Plataforma de destino Windows
Encabezado mfapi.h
Library Mfplat.lib
Archivo DLL Mfplat.dll

Consulte también

Funciones de Media Foundation

API de media Foundation Platform

Colas de trabajo