Abilitazione della registrazione

Windows Media Device Manager fornisce un oggetto di registrazione in grado di 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é Gestione dispositivi multimediali di Windows non consente di collegare un debugger a un processo che gestisce i file protetti da DRM.

Il 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 Device Manager 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 AAAAAMMGGHHMMSS, usando un'ora locale di 24 ore. Windows Media Device Manager registra tutte le chiamate API, insieme alle voci che aggiungi chiamando i messaggi di IWMDMLogger. Tutte le voci del file di log vengono aggiunte al file fino a quando non viene chiamato Reset 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.

I passaggi seguenti illustrano 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; in caso contrario, abilitarlo chiamando IWMDMLogger::Enable.
4. Specificare il nome e le dimensioni del file di log personalizzati. A tale scopo, chiamare IWMDMLogger::SetLogFileName e IWMDMLogger::SetSizeParams.
5. Nei punti del codice in cui si desidera 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) oppure chiamare IWMDMLogger::LogString per registrare stringhe costanti.

Per un esempio di codice, vedere le pagine di riferimento per i metodi di IWMDMLogger.

Argomenti correlati

attività comuni alle applicazioni e ai provider di servizi