StorPortEtwEvent4-Funktion (storport.h)
StorPortEtwEvent4 protokolliert ein ETW-Ereignis (Event Tracing for Windows) mit vier allgemeinen ETW-Parametern in einem Speicherablaufverfolgungskanal.
Syntax
ULONG StorPortEtwEvent4(
[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
);
Parameter
[in] HwDeviceExtension
Ein Zeiger auf die Geräteerweiterung des Miniports.
[in, optional] Address
Die Geräteadresse der Speichereinheit. Dieser Parameter ist für Adaptergeräte NULL.
[in] EventId
Ein durch Miniport definierter Bezeichner für das ETW-Ereignis.
[in] EventDescription
Der Beschreibungstext für das Ereignis. Diese Textzeichenfolge muss = STORPORT_ETW_MAX_DESCRIPTION_LENGTH sein <.
[in] EventKeywords
Schlüsselwortflags für die Ereigniskategorisierung. Legen Sie auf 0 fest, wenn keine Schlüsselwort (keyword) gewünscht ist. Die Schlüsselwörter sind eine bitweise OR-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 ist leistungsbezogen. |
| 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äteenumeration. |
[in] EventLevel
Die Ereignisebene. Dieser Wert kann die Wichtigkeit oder den Schweregrad des Ereignisses angeben. Dies ist einer der folgenden Werte.
| Wert | Bedeutung |
|---|---|
| StorportEtwLevelLogAlways | Protokollieren Sie das Ereignis bedingungslos. Das Ereignis wird unabhängig von den festgelegten Filtern protokolliert. |
| StorportEtwLevelCritical | Ereignis der kritischen Ebene. |
| StorportEtwLevelError | Fehlerebenenereignis. |
| StorportEtwLevelWarning | Warnstufenereignis. |
| StorportEtwLevelInformational | Informationsereignis. |
| StorportEtwLevelVerbose | Ausführliche Ereignisinformationen bereitgestellt. |
[in] EventOpcode
Die betriebliche Natur des Ereignisses. Dies ist einer der folgenden Werte.
| Wert | Bedeutung |
|---|---|
| StorportEtwEventOpcodeInfo | Allgemeines Informationsereignis. |
| StorportEtwEventOpcodeStart | Das Gerät oder die Einheit wurde gestartet. |
| StorportEtwEventOpcodeStop | Das Gerät oder die Einheit wurde beendet. Das Ereignis entspricht dem letzten ungekoppelten Startereignis. |
| StorportEtwEventOpcodeDC_Start | Ein Startereignis für die Datensammlung. Hierbei handelt es sich um Rundownereignistypen. |
| StorportEtwEventOpcodeDC_Stop | Ein Ereignis zum Beenden der Datensammlung. Hierbei handelt es sich um Rundownereignistypen. |
| StorportEtwEventOpcodeExtension | Ein Erweiterungsereignis. |
| StorportEtwEventOpcodeReply | Ein Antwortereignis. |
| StorportEtwEventOpcodeResume | Das Gerät oder die Einheit wurde nach dem Anhalten fortgesetzt. |
| StorportEtwEventOpcodeSuspend | Das Gerät oder die Einheit wird bis zum Abschluss eines anderen Vorgangs angehalten. |
| StorportEtwEventOpcodeReceive | Die Übertragung der Aktivität wird von einer anderen Komponente empfangen. |
[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. Diese Parameternamenzeichenfolge muss = STORPORT_ETW_MAX_PARAM_NAME_LENGTH sein <.
[in] Parameter1Value
Der Wert für Parameter 1.
[in, optional] Parameter2Name
Eine Beschreibung der Bedeutung von Parameter2Value. Diese Parameternamenzeichenfolge muss = STORPORT_ETW_MAX_PARAM_NAME_LENGTH sein <.
[in] Parameter2Value
Der Wert für Parameter 2.
[in, optional] Parameter3Name
Eine Beschreibung der Bedeutung von Parameter3Value. Diese Parameternamenzeichenfolge muss = STORPORT_ETW_MAX_PARAM_NAME_LENGTH sein <.
[in] Parameter3Value
Der Wert für Parameter 3.
[in, optional] Parameter4Name
Eine Beschreibung der Bedeutung von Parameter4Value. Diese Parameternamenzeichenfolge muss = STORPORT_ETW_MAX_PARAM_NAME_LENGTH sein <.
[in] Parameter4Value
Der Wert für Parameter 4.
Rückgabewert
StorPortEtwEvent4 gibt einen der folgenden status Codes 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 | Ein Parameter ist ungültig. Beispielsweise sind HwDeviceExtension oder EventDescription NULL, EventDescription ist größer als die maximale Namenslänge oder ein ETW-Parametername ist größer als die maximale Namenslänge. |
Hinweise
Ein Miniport kann StorPortEtwEvent4 aufrufen, um vier allgemeine ETW-Parameter zu protokollieren. Die ETW-Parameter werden als vier 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 |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 |
| Zielplattform | Universell |
| Header | storport.h (Storport.h einschließen) |
| IRQL | <= DISPATCH_LEVEL |