Função MFLockPlatform (mfapi.h)
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 |
|---|---|
|
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 |