StorPortEtwEvent2-Funktion (storport.h)
StorPortEtwEvent2 protokolliert ein ETW-Ereignis (Event Tracing for Windows) mit zwei allgemeinen ETW-Parametern in einem Speicherablaufverfolgungskanal.
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 Geräteerweiterung des Miniports.
[in, optional] Address
Die Geräteadresse der Speichereinheit. Dieser Parameter ist NULL für Adaptergeräte.
[in] EventId
Ein miniportdefinierter 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. Bei den Schlüsselwörtern handelt es sich um eine bitweise OR-Kombination der folgenden Elemente.
| 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äteaufzählung. |
[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 beliebigen Filtereinstellungen protokolliert. |
| StorportEtwLevelCritical | Ereignis auf kritischer Ebene. |
| StorportEtwLevelError | Fehlerebenenereignis. |
| StorportEtwLevelWarning | Ereignis der Warnungsstufe. |
| StorportEtwLevelInformational | Informationsereignis. |
| StorportEtwLevelVerbose | Ausführliche Ereignisinformationen bereitgestellt. |
[in] EventOpcode
Der betriebliche Charakter 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 unbezahlten Startereignis. |
| StorportEtwEventOpcodeDC_Start | Ein Datensammlungsstartereignis. 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 wieder 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 zugehörige 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.
Rückgabewert
StorPortEtwEvent2 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 | Einer der 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 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.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8.1 |
| Zielplattform | Universell |
| Header | storport.h (einschließlich Storport.h) |
| IRQL | <= DISPATCH_LEVEL |