Condividi tramite

Abilitazione della registrazione

  • Articolo

Windows Media Gestione dispositivi fornisce un oggetto di registrazione che può salvare le informazioni in un file di testo in fase di esecuzione. Gli sviluppatori di applicazioni e provider di servizi possono usare questo oggetto per archiviare i messaggi in un file di log durante l'esecuzione dell'applicazione o del provider di servizi. Questo oggetto è particolarmente utile quando si gestiscono file protetti da DRM, perché Windows Media Gestione dispositivi non consente di collegare un debugger a un processo che gestisce i file protetti da DRM.

Logger è un oggetto COM con l'ID classe CLSID_WMDMLogger che espone un'interfaccia, IWMDMLogger. I componenti non necessitano di un certificato per l'uso dell'oggetto di registrazione.

Per impostazione predefinita, Windows Media Gestione dispositivi gestisce un file di log, indipendentemente dal fatto che un'applicazione usi IWMDMLogger. Questo file di log è un file di testo semplice e ogni voce include una voce preceduta da un timestamp nel formato AAAAAMMDHHMMSS, usando l'ora locale di 24 ore. Windows Media Gestione dispositivi registra tutte le chiamate API, insieme alle voci aggiunte chiamando i messaggi IWMDMLogger. Tutte le voci del file di log vengono aggiunte al file fino a quando non viene chiamato Reimposta o il file supera le dimensioni massime. Il file viene chiuso automaticamente dopo ogni operazione di registrazione. Lo stesso file di log viene usato per le voci dell'applicazione e le voci di sistema.

La procedura seguente illustra come usare l'oggetto di registrazione:

  1. Includere wmdmlog.h nel progetto.
  2. Creare un oggetto di registrazione chiamando CoCreateInstance(CLSID_WMDMLogger) e richiedendo l'interfaccia IWMDMLogger . Assegnare il puntatore dell'interfaccia a una variabile globale.
  3. Verificare che la registrazione sia abilitata chiamando IWMDMLogger::IsEnabled; se non è, abilitarlo chiamando IWMDMLogger::Enable.
  4. Specificare un nome e le dimensioni del file di log personalizzati. Questa operazione viene eseguita chiamando IWMDMLogger::SetLogFileName e IWMDMLogger::SetSizeParams.
  5. Nei punti del codice in cui si vuole creare una voce nel log, chiamare IWMDMLogger::LogDword per registrare stringhe contenenti variabili (questo metodo è simile a wsprintf nel modo in cui consente di formattare una stringa contenente un valore variabile) o chiamare IWMDMLogger::LogString per registrare le stringhe costanti.

Ad esempio, vedere le pagine di riferimento per i metodi di IWMDMLogger.

Attività comuni a applicazioni e provider di servizi