Funzione StorPortEtwEvent4 (storport.h)

Articolo
02/07/2025

Un miniport chiama StorPortEtwEvent4 per registrare un evento ETW con quattro parametri ETW per utilizzo generico in un canale di traccia di archiviazione.

Sintassi

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
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo hardware per la scheda bus host (HBA).

[in/optional] Address

Indirizzo del dispositivo dell'unità di archiviazione. Questo parametro è NULL per i dispositivi adattatori.

[in] EventId

Identificatore definito dal miniport per identificare in modo univoco il tipo di evento.

[in] EventDescription

Stringa obbligatoria che descrive l'evento. La dimensione massima della stringa è STORPORT_ETW_MAX_DESCRIPTION_LENGTH caratteri, senza includere il carattere di terminazione Null.

[in] EventKeywords

Flag di parole chiave per la categorizzazione degli eventi. Impostare su 0 se non si desidera alcuna parola chiave. Le parole chiave sono una combinazione OR bit per bit delle opzioni seguenti.

Valore	Significato
STORPORT_ETW_EVENT_KEYWORD_IO	L'evento è correlato alle operazioni di I/O del dispositivo.
STORPORT_ETW_EVENT_KEYWORD_PERFORMANCE	L'evento è correlato alle prestazioni.
STORPORT_ETW_EVENT_KEYWORD_POWER	L'evento è correlato all'alimentazione del dispositivo.
STORPORT_ETW_EVENT_KEYWORD_ENUMERATION	L'evento è correlato all'enumerazione del dispositivo.

[in] EventLevel

Valore STORPORT_ETW_LEVEL che specifica l'importanza o la gravità dell'evento.

[in] EventOpcode

Valore STORPORT_ETW_EVENT_OPCODE che specifica la natura operativa dell'evento.

[in/optional] Srb

Puntatore a SRB associato all'evento registrato. Se questo parametro contiene un SRB valido, questo puntatore SRB e il puntatore SRB associato vengono registrati.

[in/optional] Parameter1Name

Descrizione del significato di Parameter1Value. La dimensione massima della stringa è STORPORT_ETW_MAX_PARAM_NAME_LENGTH caratteri, senza includere il carattere di terminazione Null.

[in] Parameter1Value

Valore per il parametro 1.

[in/optional] Parameter2Name

Descrizione del significato di Parameter2Value. La dimensione massima della stringa è STORPORT_ETW_MAX_PARAM_NAME_LENGTH caratteri, senza includere il carattere di terminazione Null.

[in] Parameter2Value

Valore per il parametro 2.

[in/optional] Parameter3Name

Descrizione del significato di Parameter3Value. La dimensione massima della stringa è STORPORT_ETW_MAX_PARAM_NAME_LENGTH caratteri, senza includere il carattere di terminazione Null.

[in] Parameter3Value

Valore per il parametro 3.

[in/optional] Parameter4Name

Descrizione del significato di Parameter4Value. La dimensione massima della stringa è STORPORT_ETW_MAX_PARAM_NAME_LENGTH caratteri, senza includere il carattere di terminazione Null.

[in] Parameter4Value

Valore per il parametro 4.

Valore restituito

storPortEtwEvent4 restituisce uno dei codici di stato seguenti:

Codice restituito	Descrizione
STOR_STATUS_SUCCESS	L'evento è stato registrato correttamente.
STOR_STATUS_NOT_IMPLEMENTED	La traccia non è abilitata per gli eventi di archiviazione.
STOR_STATUS_INVALID_PARAMETER	Uno dei parametri non è valido. Ad esempio, HwDeviceExtension o EventDescription sono NULL, EventDescription è maggiore della lunghezza massima del nome o un nome di parametro ETW è maggiore della lunghezza massima del nome.

Osservazioni

Un miniport può chiamare StorPortEtwEvent4 per registrare quattro parametri ETW per utilizzo generico. I parametri ETW sono espressi come quattro coppie nome-valore. Se un parametro non è denominato (parametroXName = NULL), la routine imposta il valore del parametro corrispondente su 0.

Gli eventi generati dai driver miniport StorPort vengono registrati nel canale ETW "Microsoft-Windows-Storage-Storport/Diagnose".