Storport 事件記錄延伸模組

就像許多其他驅動程式類型一樣，Storport 迷你埠驅動程式必須在系統事件記錄檔中建立專案，讓系統管理員知道附加存放裝置的條件。 這些事件記錄檔專案通常是為了回應裝置相關的失敗而建立。 事件也可以記錄以進行遙測、偵錯和優化。

雖然 Windows 核心本身提供彈性的介面來建立事件記錄專案，但 Storport 迷你埠模型不允許迷你埠驅動程式直接存取該介面。 相反地，Storport 會提供核心系統事件記錄功能周圍的包裝函式，而迷你埠驅動程式會使用包裝函式來建立事件記錄專案。

具體而言，Storport 提供下列事件記錄檔常式：

• StorPortLogTelemetryEx可讓迷你埠記錄追蹤量值或遙測事件，以及迷你埠自訂資料 (Windows 10 1903 版和更新版本) 。
• StorPortEtwChannelEvent2、StorPortEtwChannelEvent4和StorPortEtwChannelEvent8允許迷你埠將 ETW 事件發佈至儲存體追蹤通道， (Windows 10 1809 版和更新版本) 。
• StorPortLogSystemEvent 可讓迷你埠在 Windows 7 和更新版本) (建立事件記錄專案。

Storport 會在 「Microsoft-Windows-Storage-Storport」 提供者名稱下記錄事件。 錯誤會記錄在操作通道中，而且偵錯/分析會記錄在診斷 (分析和偵錯) 。 使用事件檢視器應用程式時，您必須先啟用[診斷通道] 來檢視 (啟用，然後按一下 [檢視顯示 > 分析和偵錯記錄]) 。

上述函式會實作為 Storport 擴充函式，而且可以使用現有的擴充函式介面來使用迷你埠驅動程式。 使用擴充函式介面可避免直接動態連結參考至新的函式。 藉由避免直接參考，使用新函式的迷你埠驅動程式會在不支援函式的作業系統上正確載入，並在不支援時傳回STOR_STATUS_NOT_IMPLEMENTED函式。 如此一來，廠商就可以建立可在多個 OS 版本上執行的單一迷你埠驅動程式，並利用支援的新事件記錄函式。

注意： 在 Windows 7 之前的 Storport 版本中，Storport 的系統事件記錄檔介面 StorPortLogError可讓迷你埠驅動程式存取核心系統事件記錄檔設施的一小部分功能，這會影響迷你埠事件記錄專案的實用性。

如需 Windows 事件的一般資訊，請參閱 Windows 事件。