StorPortEtwEvent2-Funktion (storport.h)

Artikel
02/07/2025

Ein Miniport ruft StorPortEtwEvent2 auf, um ein ETW-Ereignis mit zwei allgemeinen ETW-Parametern in einem Speicherablaufverfolgungskanal zu protokollieren.

Syntax

ULONG StorPortEtwEvent2(
  [in]          PVOID                                                        HwDeviceExtension,
  [in/optional] PSTOR_ADDRESS                                                Address,
  [in]          ULONG                                                        EventId,
  [in]          PWSTR                                                        EventDescription,
  [in]          ULONGLONG                                                    EventKeywords,
  [in]          STORPORT_ETW_LEVEL                                           EventLevel,
  [in]          STORPORT_ETW_EVENT_OPCODE                                    EventOpcode,
  [in/optional] PSCSI_REQUEST_BLOCK                                          Srb,
  [in/optional] _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter1Name,
  [in]          ULONGLONG                                                    Parameter1Value,
  [in/optional] _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter2Name,
  [in]          ULONGLONG                                                    Parameter2Value
);

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Hardwaregeräteerweiterung für den Hostbusadapter (HBA).

[in/optional] Address

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

[in] EventId

Ein miniportdefinierter Bezeichner, um den Ereignistyp eindeutig zu identifizieren.

[in] EventDescription

Erforderliche Zeichenfolge, die das Ereignis beschreibt. Die maximale Größe der Zeichenfolge ist STORPORT_ETW_MAX_DESCRIPTION_LENGTH Zeichen, nicht einschließlich des Null-Terminators.

[in] EventKeywords

Stichwortkennzeichnungen für die Ereigniskategorisierung. Legen Sie auf 0 fest, wenn kein Schlüsselwort gewünscht wird. Die Schlüsselwörter sind eine bitweise ODER-Kombination der folgenden.

Wert	Bedeutung
STORPORT_ETW_EVENT_KEYWORD_IO	Das Ereignis bezieht sich auf Geräte-E/A-Vorgänge.
STORPORT_ETW_EVENT_KEYWORD_PERFORMANCE	Das Ereignis bezieht sich auf die Leistung.
STORPORT_ETW_EVENT_KEYWORD_POWER	Das Ereignis bezieht sich auf die Geräteleistung.
STORPORT_ETW_EVENT_KEYWORD_ENUMERATION	Das Ereignis bezieht sich auf die Geräteaufzählung.

[in] EventLevel

Ein STORPORT_ETW_LEVEL Wert, der die Wichtigkeit oder den Schweregrad des Ereignisses angibt.

[in] EventOpcode

Ein STORPORT_ETW_EVENT_OPCODE Wert, der den betrieblichen Charakter des Ereignisses angibt.

[in/optional] Srb

Ein Zeiger auf den SRB, der dem protokollierten Ereignis zugeordnet ist. Wenn dieser Parameter einen gültigen SRB enthält, werden dieser SRB-Zeiger und der zugeordnete SRB-Zeiger protokolliert.

[in/optional] Parameter1Name

Eine Beschreibung der Bedeutung von Parameter1Value. Die maximale Größe der Zeichenfolge ist STORPORT_ETW_MAX_PARAM_NAME_LENGTH Zeichen, nicht einschließlich des Null-Terminators.

[in] Parameter1Value

Der Wert für Parameter 1.

[in/optional] Parameter2Name

Eine Beschreibung der Bedeutung von Parameter2Value. Die maximale Größe der Zeichenfolge ist STORPORT_ETW_MAX_PARAM_NAME_LENGTH Zeichen, nicht einschließlich des Null-Terminators.

[in] Parameter2Value

Der Wert für Parameter 2.

Rückgabewert

StorPortEtwEvent2- gibt einen der folgenden Statuscodes zurück:

Rückgabecode	Beschreibung
STOR_STATUS_SUCCESS	Das Ereignis wurde erfolgreich protokolliert.
STOR_STATUS_NOT_IMPLEMENTED	Die Ablaufverfolgung ist für Speicherereignisse nicht aktiviert.
STOR_STATUS_INVALID_PARAMETER	Einer der Parameter ist ungültig. Beispielsweise sind HwDeviceExtension- oder EventDescription- NULL, EventDescription- größer als die maximale Namenslänge oder ein ETW-Parametername größer als die maximale Namenslänge ist.

Bemerkungen

Ein Miniport kann StorPortEtwEvent2- aufrufen, um zwei allgemeine ETW-Parameter zu protokollieren. Die ETW-Parameter werden als zwei Name-Wert-Paare ausgedrückt. Wenn ein Parameter nicht benannt ist (ParameterXName = NULL), legt die Routine den entsprechenden Parameterwert auf 0 fest.

Ereignisse, die von StorPort-Miniporttreibern generiert werden, werden im ETW-Kanal "Microsoft-Windows-Storage-Storport/Diagnose" protokolliert.