Condividi tramite


Funzione StorPortEtwEvent2 (storport.h)

StorPortEtwEvent2 registra un evento ETW (Event Tracing for Windows) con due parametri ETW per utilizzo generico in un canale di traccia di archiviazione.

Sintassi

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

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.

Valore restituito

StorPortEtwEvent2 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 StorPortEtwEvent2 per registrare due parametri ETW per utilizzo generico. I parametri ETW sono espressi come due coppie nome-valore. Se un parametro non è denominato (ParameterXName = NULL), la routine imposterà il valore del parametro corrispondente su 0.

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

Requisiti

Requisito Valore
Client minimo supportato Windows 8.1
Piattaforma di destinazione Universale
Intestazione storport.h (include Storport.h)
IRQL <= DISPATCH_LEVEL

Vedi anche

StorPortEtwEvent4

StorPortEtwEvent8

StorPortEtwLogByteStream

StorPortEtwLogError