共用方式為

StorPortLogTelemetry 函式 （storport.h）

  • 發行項

StorPortLogTelemetry 例程會記錄迷你埠遙測事件，以協助診斷或收集任何有用的資訊。 迷你埠可以記錄八個一般用途名稱/值組，以及長度上限為 4KB 的緩衝區，以及結構中定義的數個事件相關欄位，STORPORT_TELEMETRY_EVENT。

語法

ULONG StorPortLogTelemetry(
  [in]           PVOID                     HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS             StorAddress,
  [in]           PSTORPORT_TELEMETRY_EVENT Event
);

參數

[in] HwDeviceExtension

主機總線適配卡 （HBA） 的硬體裝置擴充功能指標。

[in, optional] StorAddress

儲存單位裝置位址。 這個參數是配接器裝置的NULL。

[in] Event

包含遙測數據承載之STORPORT_TELEMETRY_EVENT結構的指標。

傳回值

StorPortLogTelemetry 會傳回下列其中一個狀態代碼：

傳回碼 描述
STOR_STATUS_INVALID_BUFFER_SIZE
 EventBufferLength 大於 EVENT_BUFFER_MAX_LENGTH。
STOR_STATUS_INVALID_PARAMETER
 其中一個參數的指標是 NULL 或 EventBufferLength/EventBuffer 在事件結構中不相符。
STOR_STATUS_NOT_IMPLEMENTED
 此函式不會在作用中的作系統上實作。
STATUS_SUCCESS
 遙測事件數據已成功記錄。

言論

如果未命名 Event 結構中的任何參數，Event->ParameterNameX == NULL，則例程會將對應的參數值設定為 0。

如果 miniport 沒有承載可填入 Event->EventBuffer，它應該設定 Event->EventBufferLength = 0，以及 Event->EventBuffer = NULL。

要求

要求 價值
最低支援的用戶端 Windows 10 版本 1703
支援的最低伺服器 Windows Server 2016
目標平臺 窗戶
標頭 storport.h （包括 Storport.h）
IRQL 任何

另請參閱

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx