共用方式為


StorPortLogTelemetryEx 函式 (storport.h)

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

另請參閱

STOR_TELEMETRY_CATEGORY

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetry