Ativação do registro em log

O Gestor de Dispositivos do Windows Media fornece um objeto de registo que pode guardar informações num ficheiro de texto em tempo de execução. Os desenvolvedores de aplicativos e provedores de serviços podem usar esse objeto para armazenar mensagens em um arquivo de log enquanto seu aplicativo ou provedor de serviços está em execução. Este objeto é especialmente útil ao manipular arquivos protegidos por DRM, porque o Gerenciador de Dispositivos do Windows Media não permitirá que você anexe um depurador a um processo que esteja manipulando arquivos protegidos por DRM.

O logger é um objeto COM com a classe ID CLSID_WMDMLogger que expõe uma interface, IWMDMLogger. Os componentes não precisam de um certificado para usar o objeto de log.

Por predefinição, o Gestor de Dispositivos do Windows Media mantém um ficheiro de registo, independentemente de uma aplicação utilizar IWMDMLogger. Este arquivo de log é um arquivo de texto simples, e cada entrada inclui uma entrada precedida por um carimbo de data/hora no formato AAAAMMDDHHMMSS, usando a hora local de 24 horas. O Gestor de Dispositivos do Windows Media regista todas as chamadas de API, juntamente com quaisquer entradas adicionadas ao chamar mensagens de IWMDMLogger. Todas as entradas do arquivo de log são anexadas ao arquivo até que Reset seja chamado ou o arquivo exceda seu tamanho máximo. O arquivo é fechado automaticamente após cada operação de registro. O mesmo arquivo de log é usado para entradas de aplicativo e entradas do sistema.

As etapas a seguir mostram como usar o objeto de log:

  1. Inclua wmdmlog.h no seu projeto.
  2. Crie um objeto de log chamando CoCreateInstance(CLSID_WMDMLogger) e solicitando a interface IWMDMLogger. Atribua o ponteiro da interface a uma variável global.
  3. Verifique se o registro em log está habilitado chamando IWMDMLogger::IsEnabled; se não estiver, habilite-o chamando IWMDMLogger::Enable.
  4. Especifique um nome e tamanho de arquivo de log personalizado. Isso é feito chamando IWMDMLogger::SetLogFileName e IWMDMLogger::SetSizeParams.
  5. Nos pontos do código em que você deseja fazer uma entrada no log, chame IWMDMLogger::LogDword para registrar cadeias de caracteres contendo variáveis (esse método é semelhante a wsprintf na maneira como permite formatar uma cadeia de caracteres contendo um valor de variável) ou chame IWMDMLogger::LogString para registrar cadeias de caracteres constantes.

Para código de exemplo, consulte as páginas de referência para os métodos de IWMDMLogger.

tarefas comuns a aplicativos e provedores de serviços

 

 

  • Last updated on