Share via

Função MFLockPlatform (mfapi.h)

  • Artigo

Bloqueia a função MFShutdown .

Sintaxe

HRESULT MFLockPlatform();

Valor retornado

A função retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Código de retorno Descrição
S_OK
 A função foi bem-sucedida.

Comentários

Essa função impede que threads de fila de trabalho sejam desligados quando MFShutdown é chamado. Use essa função para garantir que as operações assíncronas são concluídas normalmente antes que a plataforma seja desligada.

Essa função mantém um bloqueio na plataforma do Media Foundation. Para desbloquear a plataforma, chame MFUnlockPlatform. O aplicativo deve chamar MFUnlockPlatform uma vez para cada chamada para MFLockPlatform.

A função MFShutdown é bloqueada até que a plataforma seja desbloqueada ou até que um período de espera fixo tenha decorrido. (O período de espera é de alguns segundos.) Para evitar vazamentos de memória, o aplicativo deve desbloquear a plataforma antes que o período de espera termine. Por exemplo, cancele qualquer operação assíncrona que esteja aguardando a conclusão e mantendo um bloqueio na plataforma.

A implementação padrão da interface IMFAsyncResult bloqueia automaticamente a plataforma do Media Foundation quando o objeto de resultado é criado. Liberar a interface desbloqueia a plataforma. Portanto, na maioria dos casos, seu aplicativo não precisa bloquear a plataforma diretamente. Para obter mais informações, consulte Filas de Trabalho.

Essa função estará disponível nas seguintes plataformas se os componentes redistribuíveis do SDK do Windows Media Format 11 estiverem instalados:

  • Windows XP com Service Pack 2 (SP2) e posterior.
  • Windows XP Media Center Edition 2005 com KB900325 (Windows XP Media Center Edition 2005) e KB925766 (pacote cumulativo de atualizações de outubro de 2006 para Windows XP Media Center Edition) instalados.

Requisitos

   
Cliente mínimo com suporte Windows Vista [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2008 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho mfapi.h
Biblioteca Mfplat.lib
DLL Mfplat.dll

Confira também

Funções do Media Foundation

Media Foundation Platform APIs

Filas de Trabalho