Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows 8.1 |
| Header- | storport.h |