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 會傳回下列其中一個狀態代碼：
| 傳回碼 | Description |
|---|---|
| STOR_STATUS_INVALID_BUFFER_SIZE | 事件->EventBufferLength 大於 EVENT_BUFFER_MAX_LENGTH。 |
| STOR_STATUS_INVALID_PARAMETER | 其中一個參數的指標為 NULL，或非 NULL Event-EventBuffer> 的 EventBufferLength 設定為零。 |
| STOR_STATUS_NOT_IMPLEMENTED | 此函式不會在作用中的操作系統上實作。 |
| STOR_STATUS_SUCCESS | 已成功記錄遙測事件。 |
備註
迷你埠可以呼叫 StorPortLogTelemetryEx ，以使用迷你埠自定義數據來記錄追蹤量值或遙測事件。 迷你埠會在 Category 中指定事件類別目錄類型。
事件數據會封裝在事件指向的STORPORT_TELEMETRY_EVENT結構中。 迷你埠可以記錄八個一般用途名稱/值組，以及長度上限為 4KB 的緩衝區，以及數個事件相關字段。
規格需求
| 需求 | 值 |
|---|---|
| 標頭 | storport.h |