StorPortEtwLogError-Funktion (storport.h)

Artikel
02/07/2025

StorPortEtwLogError protokolliert ein Ereignisablaufverfolgungsereignis für Windows (ETW) für einen Hardwareprotokollfehler.

Syntax

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

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Geräteerweiterung des Miniports.

[in, optional] Address

Die Adresse des Speichergeräts. Dieser Parameter ist NULL für Adaptergeräte.

[in] Id

Eine miniportdefinierte Ereignis-ID, die das Ereignis eindeutig identifiziert.

[in] Description

Der Beschreibungstext für den Fehler. Dieser Parameter ist erforderlich.

[in] DataBufferLength

Größe DataBuffer-in Byte.

[in] DataBuffer

Ein Puffer mit variabler Größe, der treiberspezifische Binärdaten enthält, die hilfreich sind, um die Ursache des Fehlers zu identifizieren. Treiber müssen die Größe dieses Puffers im DataBufferLength Parameter angeben.

Rückgabewert

Diese Funktion gibt einen der folgenden Statuscodes zurück.

Rückgabecode	Beschreibung
STOR_STATUS_SUCCESS	Das Ereignis wurde erfolgreich protokolliert.
STOR_STATUS_INVALID_PARAMETER	Beschreibung oder DataBuffer- null oder DataBufferLength- nicht größer als Null ist.
STOR_STATUS_UNSUCCESSFUL	StorPort konnte das ETW-Ereignis aus anderen Gründen nicht protokollieren, z. B. die ETW-Protokollierung ist nicht aktiviert.

Bemerkungen

Ein Miniport kann StorPortEtwLogError- aufrufen, um ein ETW-Ereignis für einen Hardwareprotokollfehler zu protokollieren. Ereignisse, die aus dieser Funktion generiert werden, werden im ETW-Kanal "Microsoft-Windows-Storage-Storport/Operational" veröffentlicht.