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 會傳回下列其中一個狀態代碼：

傳回碼 Description
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
目標平台 Windows
標頭 storport.h (包含 Storport.h)
IRQL 任何

另請參閱

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx