Windows 媒體設備管理員提供記錄物件,可在運行時間將資訊儲存至文字檔。 應用程式和服務提供者的開發人員都可以在應用程式或服務提供者執行時,使用此物件將訊息儲存在記錄檔中。 處理受DRM保護的檔案時,此物件特別有用,因為Windows媒體設備管理員不會允許您將調試程式附加至處理DRM保護檔案的程式。
記錄器是具有類別標識碼CLSID_WMDMLogger的 COM 物件,會公開一個介面,IWMDMLogger。 元件不需要憑證才能使用記錄物件。
Windows 媒體設備管理器預設會維護記錄檔,不論應用程式是否使用 IWMDMLogger 。 此記錄檔是一個簡單的文本檔案,每個記錄都包含一個條目,前面附上一個時間戳記,格式為YYYYMMDDHHMMSS,使用24小時制當地時間。 Windows 媒體設備管理員會記錄所有的 API 呼叫,還有您透過呼叫 IWMDMLogger 訊息所新增的任何項目。 所有記錄檔項目都會附加至檔案,直到呼叫 Reset,或檔案超過其大小上限為止。 檔案會在每次記錄作業之後自動關閉。 相同的記錄檔用於應用程式專案和系統專案。
下列步驟示範如何使用記錄物件:
- 在您的專案中包含 wmdmlog.h。
- 藉由呼叫 CoCreateInstance(CLSID_WMDMLogger), 並要求 IWMDMLogger 介面,以建立記錄物件。 將介面指標指派給全域變數。
- 呼叫 IWMDMLogger::IsEnabled確認已啟用記錄;如果不是,請呼叫 IWMDMLogger::Enable加以啟用。
- 指定自訂記錄檔名稱和大小。 這是藉由呼叫 IWMDMLogger::SetLogFileName 和 IWMDMLogger::SetSizeParams來完成。
- 在您要在記錄檔中進行記錄的程式代碼點,呼叫 IWMDMLogger::LogDword 來記錄包含變數的字串(此方法類似於 wsprintf,在格式化包含變數值的字串方面),或呼叫 IWMDMLogger::LogString 來記錄常數字串。
如需範例程式代碼,請參閱 IWMDMLogger方法的參考頁面。
相關主題
-
應用程式與服務提供者常見的工作