Share via

Função MFStartup (mfapi.h)

  • Artigo

Inicializa o Microsoft Media Foundation.

Sintaxe

HRESULT MFStartup(
  ULONG Version,
  DWORD dwFlags
);

Parâmetros

Version

Número da versão. Use o valor MF_VERSION, definido em mfapi.h.

dwFlags

Esse parâmetro é opcional ao usar C++, mas necessário em C. O valor deve ser um dos seguintes sinalizadores:

Valor Significado
MFSTARTUP_NOSOCKET
 Não inicialize a biblioteca de soquetes.
MFSTARTUP_LITE
 Equivalente a MFSTARTUP_NOSOCKET.
MFSTARTUP_FULL
 Inicialize toda a plataforma do Media Foundation. Esse é o valor padrão quando dwFlags não é especificado.

Retornar valor

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
 O método foi bem-sucedido.
MF_E_BAD_STARTUP_VERSION
 O parâmetro Version requer uma versão mais recente do Media Foundation do que a versão em execução.
MF_E_DISABLED_IN_SAFEMODE
 A plataforma Media Foundation está desabilitada porque o sistema foi iniciado no "Modo de Segurança" (inicialização à prova de falhas).
E_NOTIMPL
 O Media Foundation não é implementado no sistema. Esse erro poderá ocorrer se os componentes de mídia não estiverem presentes ( consulte KB2703761 para obter mais informações).

Comentários

Um aplicativo deve chamar essa função antes de usar o Media Foundation. Antes que o aplicativo seja encerrado, chame MFShutdown uma vez para cada chamada anterior para MFStartup.

MFStartup deve ser chamado durante deve ser chamado durante a inicialização do aplicativo e não de construtores estáticos durante a inicialização do processo.

Não chame MFStartup ou MFShutdown de threads de fila de trabalho. Para obter mais informações sobre filas de trabalho, 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.

Exemplos

    hr = MFStartup(MF_VERSION);

Requisitos

Requisito Valor
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

Inicializando o Media Foundation

Funções do Media Foundation