StorPortEtwEvent8-Funktion (storport.h)
Ein Miniport ruft StorPortEtwEvent8- auf, um ein ETW-Ereignis mit acht allgemeinen ETW-Parametern in einem Speicherablaufverfolgungskanal zu protokollieren.
Syntax
ULONG StorPortEtwEvent8(
[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,
[in/optional] _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter3Name,
[in] ULONGLONG Parameter3Value,
[in/optional] _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter4Name,
[in] ULONGLONG Parameter4Value,
[in/optional] _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter5Name,
[in] ULONGLONG Parameter5Value,
[in/optional] _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter6Name,
[in] ULONGLONG Parameter6Value,
[in/optional] _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter7Name,
[in] ULONGLONG Parameter7Value,
[in/optional] _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter8Name,
[in] ULONGLONG Parameter8Value
);
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.
[in/optional] Parameter3Name
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.
[in] Parameter3Value
Der Wert für Parameter 3.
[in/optional] Parameter4Name
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.
[in] Parameter4Value
Der Wert für Parameter 4.
[in/optional] Parameter5Name
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.
[in] Parameter5Value
Der Wert für Parameter 5.
[in/optional] Parameter6Name
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.
[in] Parameter6Value
Der Wert für Parameter 6.
[in/optional] Parameter7Name
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.
[in] Parameter7Value
Der Wert für Parameter 7.
[in/optional] Parameter8Name
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.
[in] Parameter8Value
Der Wert für Parameter 8.
Rückgabewert
StorPortEtwEvent8 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 StorPortEtwEvent8- 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 ETW-Kanal "Microsoft-Windows-Storage-Storport/Diagnose" protokolliert.
Anforderungen
Anforderung | Wert |
---|---|
mindestens unterstützte Client- | Windows 8.1 |
Zielplattform- | Universal |
Header- | storport.h (include Storport.h) |
IRQL- | <= DISPATCH_LEVEL |