Funzione StorPortEtwEvent8 (storport.h)
StorPortEtwEvent8 registra un evento ETW (Event Tracing for Windows) con otto parametri ETW per utilizzo generico in un canale di traccia di archiviazione.
Sintassi
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
);
Parametri
[in] HwDeviceExtension
Puntatore all'estensione del dispositivo del miniport.
[in, optional] Address
Indirizzo del dispositivo dell'unità di archiviazione. Questo parametro è NULL per i dispositivi adattatori.
[in] EventId
Identificatore definito dal miniport per l'evento ETW.
[in] EventDescription
Testo della descrizione per l'evento. Questa stringa di testo deve essere <= STORPORT_ETW_MAX_DESCRIPTION_LENGTH.
[in] EventKeywords
Flag di parole chiave per la categorizzazione degli eventi. Impostare su 0 se non si vuole usare alcuna parola chiave. Le parole chiave sono una combinazione OR bit per bit della seguente.
| 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 alla potenza del dispositivo. |
| STORPORT_ETW_EVENT_KEYWORD_ENUMERATION | L'evento è correlato all'enumerazione del dispositivo. |
[in] EventLevel
Livello di evento. Questo valore può indicare l'importanza o la gravità dell'evento. Si tratta di uno dei valori seguenti.
| Valore | Significato |
|---|---|
| StorportEtwLevelLogAlways | Registrare l'evento in modo incondizionato. L'evento viene registrato indipendentemente da qualsiasi set di filtri. |
| StorportEtwLevelCritical | Evento di livello critico. |
| StorportEtwLevelError | Evento a livello di errore. |
| StorportEtwLevelWarning | Evento del livello di avviso. |
| StorportEtwLevelInformational | Evento informativo. |
| StorportEtwLevelVerbose | Informazioni dettagliate sull'evento fornite. |
[in] EventOpcode
Natura operativa dell'evento. Si tratta di uno dei valori seguenti.
| Valore | Significato |
|---|---|
| StorportEtwEventOpcodeInfo | Evento informativo generale. |
| StorportEtwEventOpcodeStart | Avvio del dispositivo o dell'unità. |
| StorportetweventOpcodestop | Il dispositivo o l'unità è stato arrestato. L'evento corrisponde all'ultimo evento di avvio non abbinato. |
| StorportEtwEventOpcodeDC_Start | Evento iniziale della raccolta dati. Si tratta di tipi di evento rundown. |
| StorportEtwEventOpcodeDC_Stop | Evento di arresto della raccolta dati. Si tratta di tipi di evento rundown. |
| StorportEtwEventOpcodeExtension | Evento di estensione. |
| StorportEtwEventOpcodeReply | Evento di risposta. |
| StorportEtwEventOpcodeResume | Il dispositivo o l'unità è stato ripreso dopo la sospensione. |
| StorportEtwEventOpcodeSuspend | Il dispositivo o l'unità è sospeso in attesa del completamento di un'altra operazione. |
| StorportEtwEventOpcodeReceive | Il trasferimento dell'attività viene ricevuto da un altro componente. |
[in, optional] Srb
Puntatore all'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 stringa del nome del parametro deve essere <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.
[in] Parameter1Value
Valore per il parametro 1.
[in, optional] Parameter2Name
Descrizione del significato di Parameter2Value. La stringa del nome del parametro deve essere <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.
[in] Parameter2Value
Valore per il parametro 2.
[in, optional] Parameter3Name
Descrizione del significato di Parameter3Value. La stringa del nome del parametro deve essere <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.
[in] Parameter3Value
Valore per il parametro 3.
[in, optional] Parameter4Name
Descrizione del significato di Parameter4Value. La stringa del nome del parametro deve essere <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.
[in] Parameter4Value
Valore per il parametro 4.
[in, optional] Parameter5Name
Descrizione del significato di Parameter5Value. La stringa del nome del parametro deve essere <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.
[in] Parameter5Value
Valore per il parametro 5.
[in, optional] Parameter6Name
Descrizione del significato di Parameter6Value. La stringa del nome del parametro deve essere <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.
[in] Parameter6Value
Valore per il parametro 6.
[in, optional] Parameter7Name
Descrizione del significato di Parameter7Value. La stringa del nome del parametro deve essere <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.
[in] Parameter7Value
Valore per il parametro 7.
[in, optional] Parameter8Name
Descrizione del significato di Parameter8Value. La stringa del nome del parametro deve essere <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.
[in] Parameter8Value
Valore per il parametro 8.
Valore restituito
StorPortEtwEvent8 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. |
Commenti
Un miniport può chiamare StorPortEtwEvent8 per registrare otto parametri ETW per utilizzo generico. I parametri ETW vengono espressi come otto 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/Diagnosi".
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8.1 |
| Piattaforma di destinazione | Universale |
| Intestazione | Storport.h (include Storport.h) |
| IRQL | <= DISPATCH_LEVEL |