StorPortLogTelemetry 例程會記錄迷你埠遙測事件,以協助診斷或收集任何有用的資訊。
語法
ULONG StorPortLogTelemetryEx(
PVOID HwDeviceExtension,
PSTOR_ADDRESS StorAddress,
PSTORPORT_TELEMETRY_EVENT Event,
STOR_TELEMETRY_CATEGORY Category
);
參數
HwDeviceExtension
主機總線適配卡的硬體裝置擴充功能指標(HBA)。
StorAddress
儲存單位裝置位址。 這個參數是配接器裝置的NULL。
Event
包含遙測數據承載之 STORPORT_TELEMETRY_EVENT 結構的指標。
Category
STOR_TELEMETRY_CATEGORY 列舉值,指定要記錄的遙測類別。
傳回值
StorPortLogTelemetryEx 會傳回下列其中一個狀態代碼:
傳回碼 | 描述 |
---|---|
STOR_STATUS_INVALID_BUFFER_SIZE | Event->EventBufferLength 大於 EVENT_BUFFER_MAX_LENGTH。 |
STOR_STATUS_INVALID_PARAMETER | 其中一個參數的指標是 NULL,或者>EventBufferLength 會針對非 NULL EventBuffer設定為零。 |
STOR_STATUS_NOT_IMPLEMENTED | 此函式不會在作用中的作系統上實作。 |
STOR_STATUS_SUCCESS | 已成功記錄遙測事件。 |
言論
迷你埠可以呼叫 StorPortLogTelemetryEx,以使用迷你埠自定義的數據來記錄追蹤記錄量值或遙測事件。 Miniports 在 Category中指定事件類別類型。
事件數據會封裝在 事件 點的 STORPORT_TELEMETRY_EVENT 結構中。 迷你埠可以記錄八個一般用途名稱/值組,以及長度上限為 4KB 的緩衝區,以及數個事件相關字段。
要求
要求 | 價值 |
---|---|
標頭 | storport.h |