StorPortEtwLogError 函式 (storport.h)

發行項
03/01/2024

StorPortEtwLogError 會記錄 Windows 事件追蹤 (ETW) 硬體通訊協定錯誤。

語法

ULONG StorPortEtwLogError(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Id,
  [in]           PWSTR         Description,
  [in]           ULONG         DataBufferLength,
  [in]           PVOID         DataBuffer
);

參數

[in] HwDeviceExtension

迷你埠裝置延伸模組的指標。

[in, optional] Address

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

[in] Id

可唯一識別事件的迷你埠定義事件標識碼。

[in] Description

錯誤的描述文字。此為必要參數。

[in] DataBufferLength

DataBuffer 的大小，以位元組為單位。

[in] DataBuffer

變數大小緩衝區，其中包含驅動程式特定的二進位數據，有助於識別錯誤的原因。驅動程式必須在 DataBufferLength 參數中指定這個緩衝區的大小。

傳回值

此函式會傳回下列其中一個狀態代碼。

傳回碼	Description
STOR_STATUS_SUCCESS	已成功記錄事件。
STOR_STATUS_INVALID_PARAMETER	描述或 DataBuffer 為 NULL，或 DataBufferLength 不大於零。
STOR_STATUS_UNSUCCESSFUL	StorPort 因其他原因而無法記錄 ETW 事件，例如未啟用 ETW 記錄。