Partilhar via


Usar o MFTrace

MFTrace é uma ferramenta para gerar logs de rastreamento para aplicativos da Microsoft Media Foundation.

O MFTrace usa a biblioteca Detours para se conectar a chamadas de API da Media Foundation e gerar logs de rastreamento. O MFTrace também pode registrar rastreamentos de qualquer componente que use o Rastreamento de Eventos do Windows (ETW) ou o pré-processador de rastreamento de software (WPP) para gerar rastreamentos. Os logs de rastreamento podem ser gerados iniciando um novo processo no MFTrace ou anexando o MFTrace a um processo existente.

Uso

mftrace [-a Process][-c ConfigurationFile][-dc][-es][-k KeyWords][-l Level][-o OutputFile][-v][-?] [{COMMAND|ETL_FILE}]

Argumentos de linha de comando Descrição
-aID do processo ou nome do processo
Anexar a um processo em execução.
-cArquivo de configuração
Leia as configurações do arquivo de configuração especificado. Consulte Arquivo de configuração do MFTrace.
-dc
Desative o rastreamento para processos filhos. Por padrão, o rastreamento está habilitado para processos filhos.
-es
Ative símbolos públicos.
-kPalavras-chave
Lista de contadores separados por palavras-chave. Consulte Palavras-chave do MFTrace.
-lNível
O nível de rastreamento.
  • 0: Nenhum(a)
  • 1: Crítico
  • 2: Erro
  • 3: Aviso
  • 4: Informativo
  • 5: Detalhado
  • 16: Depurar
-oArquivo de saída
Grave a saída de rastreamento para o arquivo especificado. Por padrão, a saída vai para stdout.
Se um arquivo de saída for especificado, a extensão do nome do arquivo deverá ser uma das seguintes:
  • .etl: arquivo de log de rastreamento de eventos (ETL).
  • .log ou .txt: arquivo de texto.
-v
Habilite o modo detalhado.
-?
Exibir informações de uso.
COMANDO
Argumentos de linha de comando para criar um novo processo.
ETL_FILE
O nome de um arquivo ETL existente. Se esse argumento for fornecido, o arquivo ETL será convertido em saída de texto.

 

Variáveis de ambiente

TRACE_FORMAT_SEARCH_PATH

Para rastrear componentes que usam o pré-processador de rastreamento de software do Windows (WPP), defina essa variável de ambiente para especificar o caminho para os arquivos de formato de mensagem de rastreamento (TMF) para o componente.

_NT_SYMBOL_PATH

Se a pesquisa de símbolo estiver habilitada (-es), defina essa variável de ambiente para especificar o caminho do símbolo.

Exemplos

Crie um novo processo e rastreie esse processo:

mftrace.exe wmplayer.exe Wildlife.wmv

Anexe o MFTrace a um processo existente:

mftrace.exe -a wmplayer.exe
mftrace.exe -a 9132

Envie a saída de rastreamento para um arquivo de texto:

mftrace.exe -a wmplayer.exe -o trace.txt

Rastreie eventos do ETW ou WPP:

mftrace.exe -c config.xml -o trace.txt
mftrace.exe -c config.xml -o trace.etl

Observação

O primeiro exemplo gera um arquivo de texto. O segundo exemplo gera um arquivo ETL.

 

Converta um arquivo ETL em um arquivo de texto:

mftrace.exe -o trace.txt trace.etl

Comentários

Por padrão, o MFTrace gera apenas rastreamentos de desvios. Para gerar rastreamentos do ETW ou WPP, você deve fornecer um arquivo de configuração. O arquivo de configuração fornece os nomes dos provedores de rastreamento. Para obter mais informações, consulte Arquivo de configuração do MFTrace.

O MFTrace pode enviar a saída para os seguintes destinos:

  • stdout (o padrão).
  • Um arquivo de texto.
  • Um arquivo ETL binário.

Se você estiver registrando rastreamentos do ETW/WPP, um arquivo ETL será a opção mais eficiente, pois os dados de rastreamento são salvos como blobs binários. Após a conclusão da sessão de rastreamento, você pode usar o MFTrace para converter o arquivo ETL em um arquivo de texto.

Observação

Para o rastreamento de desvios, a saída de texto é tão eficiente quanto um arquivo ETL. Portanto, se você registrar apenas rastreamentos de desvios (sem rastreamentos do ETW/WPP), a saída de texto será recomendada.

 

Para o rastreamento de desvios, você deve anexar o MFTrace a um processo em execução (-a) ou usar o MFTrace para criar um novo processo. Para rastreamentos do ETW/WPP, o MFTrace escuta qualquer provedor de eventos listado no arquivo de configuração.

Você pode filtrar os resultados do rastreamento especificando palavras-chave, por meio da opção de linha de comando -k ou no arquivo de configuração. O uso mais comum, no entanto, é registrar todos os rastreamentos e usar um script ou grep para pesquisar padrões de cadeia de caracteres específicos.

Como interpretar os resultados de rastreamento

Você pode usar o MFTrace para responder a perguntas sobre o que acontece dentro do aplicativo ou componente da Media Foundation. A tabela a seguir lista algumas perguntas típicas. A segunda coluna fornece a cadeia de caracteres de pesquisa que pode ajudar a responder à pergunta.

Pergunta Cadeias de caracteres de pesquisa
Ocorreu um erro? "0xc00d"
A topologia foi resolvida corretamente? "CTopologyHelpers::Trace"
A sessão de mídia começou? "MESessionStarted"
Qual arquivo foi reproduzido? "CMFSourceResolverDetours"
Quais são os tipos de mídia para os fluxos de origem? "Novo fluxo", "MENewStream", "CMFMediaSourceDetours::TracePD"
Os fluxos de origem geraram amostras? "CMFMediaStreamDetours::HandleEvent", "MEMediaSample"
A reprodução chegou ao fim dos dados? "MEEndOfStream", "MEEndOfPresentation"
O formato mudou? "MEStreamFormatChanged" (origens de mídia), "Novo formato", "MESessionStreamSinkFormatChanged" (coletores de mídia)
Quais objetos foram criados? "COle32ExportDetours::CoCreateInstance"
As transformações deMedia Foundation Transforms (MFTs) no pipeline processaram algum dado? "CMFTransformDetours::ProcessOutput", "CMFTransformDetours::ProcessInput"
Quais estados foram definidos nas MFTs? "CMFTransformDetours::ProcessMessage"
Uma MFT solicitou dados de entrada? "MF_E_TRANSFORM_NEED_MORE_INPUT" (MFT síncrona), "METransformNeedInput" (MFT assíncrona).
Uma MFT assíncrona produziu dados de saída? "ProcessOutputs disponíveis"
Um coletor de mídia solicitou amostras? "MEStreamSinkRequestSample"
Um coletor de mídia recebeu amostras? "CMFStreamSinkDetours::ProcessSample"
DirectShow: quais amostras foram processadas? "amostra", "CMemInputPinDetours"
DirectShow: qual gráfico de filtro foi usado? "CGraphHelpers::Trace"
Houve vários processos? "CreateProcess" Observação: procure também o identificador de processo, que aparece no início de cada linha de rastreamento.

 

MFTrace