StorPortEtwChannelEvent8-Funktion (storport.h)

Artikel
02/07/2025

Ein Miniport ruft StorPortEtwChannelEvent8- auf, um ein ETW-Ereignis mit acht allgemeinen ETW-Parametern in einem angegebenen Kanal zu protokollieren.

Syntax

ULONG StorPortEtwChannelEvent8(
  PVOID                                                        HwDeviceExtension,
  PSTOR_ADDRESS                                                Address,
  STORPORT_ETW_EVENT_CHANNEL                                   EventChannel,
  ULONG                                                        EventId,
  PWSTR                                                        EventDescription,
  ULONGLONG                                                    EventKeywords,
  STORPORT_ETW_LEVEL                                           EventLevel,
  STORPORT_ETW_EVENT_OPCODE                                    EventOpcode,
  PSCSI_REQUEST_BLOCK                                          Srb,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter1Name,
  ULONGLONG                                                    Parameter1Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter2Name,
  ULONGLONG                                                    Parameter2Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter3Name,
  ULONGLONG                                                    Parameter3Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter4Name,
  ULONGLONG                                                    Parameter4Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter5Name,
  ULONGLONG                                                    Parameter5Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter6Name,
  ULONGLONG                                                    Parameter6Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter7Name,
  ULONGLONG                                                    Parameter7Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter8Name,
  ULONGLONG                                                    Parameter8Value
);

Parameter

HwDeviceExtension

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

Address

[in/optional] Die Adresse des Speichergeräts. Dieser Parameter ist NULL für Adaptergeräte.

EventChannel

[in] Ein STORPORT_ETW_EVENT_CHANNEL Wert, der den Storport-Kanal angibt, in dem das Ereignis protokolliert werden soll.

EventId

[in] Ein miniportdefinierter Bezeichner, um den Ereignistyp eindeutig zu identifizieren.

EventDescription

[in] 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.

EventKeywords

[in] 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.

EventLevel

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

EventOpcode

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

Srb

[in] 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.

Parameter1Name

[in] 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.

Parameter1Value

[in] Der Wert für Parameter 1.

Parameter2Name

[in] 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.

Parameter2Value

[in] Der Wert für Parameter 2.

Parameter3Name

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

Parameter3Value

[in] Der Wert für Parameter 3.

Parameter4Name

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

Parameter4Value

[in] Der Wert für Parameter 4.

Parameter5Name

[in/optional] Eine Beschreibung der Bedeutung von Parameter5Value. Die maximale Größe der Zeichenfolge ist STORPORT_ETW_MAX_PARAM_NAME_LENGTH Zeichen, nicht einschließlich des Null-Terminators.

Parameter5Value

[in] Der Wert für Parameter 5.

Parameter6Name

[in/optional] Eine Beschreibung der Bedeutung von Parameter6Value. Die maximale Größe der Zeichenfolge ist STORPORT_ETW_MAX_PARAM_NAME_LENGTH Zeichen, nicht einschließlich des Null-Terminators.

Parameter6Value

[in] Der Wert für Parameter 6.

Parameter7Name

[in/optional] Eine Beschreibung der Bedeutung von Parameter7Value. Die maximale Größe der Zeichenfolge ist STORPORT_ETW_MAX_PARAM_NAME_LENGTH Zeichen, nicht einschließlich des Null-Terminators.

Parameter7Value

[in] Der Wert für Parameter 7.

Parameter8Name

[in/optional] Eine Beschreibung der Bedeutung von Parameter8Value. Die maximale Größe der Zeichenfolge ist STORPORT_ETW_MAX_PARAM_NAME_LENGTH Zeichen, nicht einschließlich des Null-Terminators.

Parameter8Value

[in] Der Wert für Parameter 8.

Rückgabewert

StorPortEtwChannelEvent8 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 StorPortChannelEtwEvent8- aufrufen, um acht allgemeine ETW-Parameter zu protokollieren. Die ETW-Parameter werden als acht 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 kanal protokolliert, der durch EventChannelangegeben wird.