Função StorPortEtwChannelEvent4 (storport.h)

Artigo
02/07/2025

Um miniporto chama StorPortEtwChannelEvent4 para registrar um evento ETW com quatro parâmetros ETW de uso geral em um canal especificado.

Sintaxe

ULONG StorPortEtwChannelEvent4(
  PVOID                                                        HwDeviceExtension,
  PSTOR_ADDRESS                                                Address,
  STORPORT_ETW_EVENT_CHANNEL                                   EventChannel,
  ULONG                                                        EventId,
  PWSTR                                                        EventDescription,
  ULONGLONG                                                    EventKeywords,
  STORPORT_ETW_LEVEL                                           EventLevel,
  STORPORT_ETW_EVENT_OPCODE                                    EventOpcode,
  PSCSI_REQUEST_BLOCK                                          Srb,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter1Name,
  ULONGLONG                                                    Parameter1Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter2Name,
  ULONGLONG                                                    Parameter2Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter3Name,
  ULONGLONG                                                    Parameter3Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter4Name,
  ULONGLONG                                                    Parameter4Value
);

Parâmetros

HwDeviceExtension

[in] Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).

Address

[in/optional] O endereço do dispositivo da unidade de armazenamento. Esse parâmetro é NULL para dispositivos adaptador.

EventChannel

[in] Um valor STORPORT_ETW_EVENT_CHANNEL que especifica o canal storport no qual registrar o evento em log.

EventId

[in] Um identificador definido pelo miniporto para identificar exclusivamente o tipo de evento.

EventDescription

[in] Cadeia de caracteres necessária que descreve o evento. O tamanho máximo da cadeia de caracteres é STORPORT_ETW_MAX_DESCRIPTION_LENGTH caracteres, não incluindo o terminador nulo.

EventKeywords

[in] Sinalizadores de palavra-chave para categorização de eventos. Defina como 0 se nenhuma palavra-chave for desejada. As palavras-chave são uma combinação OR bit a bit do seguinte.

Valor	Significado
STORPORT_ETW_EVENT_KEYWORD_IO	O evento está relacionado às operações de E/S do dispositivo.
STORPORT_ETW_EVENT_KEYWORD_PERFORMANCE	O evento está relacionado ao desempenho.
STORPORT_ETW_EVENT_KEYWORD_POWER	O evento está relacionado à energia do dispositivo.
STORPORT_ETW_EVENT_KEYWORD_ENUMERATION	O evento está relacionado à enumeração do dispositivo.

EventLevel

[in] Um valor STORPORT_ETW_LEVEL que especifica a importância ou a gravidade do evento.

EventOpcode

[in] Um valor STORPORT_ETW_EVENT_OPCODE que especifica a natureza operacional do evento.

Srb

[in] Um ponteiro para o SRB associado ao evento registrado. Se esse parâmetro contiver um SRB válido, esse ponteiro SRB e o ponteiro SRB associado serão registrados.

Parameter1Name

[in] Uma descrição do significado de Parameter1Value. O tamanho máximo da cadeia de caracteres é STORPORT_ETW_MAX_PARAM_NAME_LENGTH caracteres, não incluindo o terminador nulo.

Parameter1Value

[in] O valor do parâmetro 1.

Parameter2Name

[in] Uma descrição do significado de Parameter2Value. O tamanho máximo da cadeia de caracteres é STORPORT_ETW_MAX_PARAM_NAME_LENGTH caracteres, não incluindo o terminador nulo.

Parameter2Value

[in] O valor do parâmetro 2.

Parameter3Name

[in] Uma descrição do significado de Parameter3Value. O tamanho máximo da cadeia de caracteres é STORPORT_ETW_MAX_PARAM_NAME_LENGTH caracteres, não incluindo o terminador nulo.

Parameter3Value

[in] O valor do parâmetro 3.

Parameter4Name

[in] Uma descrição do significado de Parameter4Value . O tamanho máximo da cadeia de caracteres é STORPORT_ETW_MAX_PARAM_NAME_LENGTH caracteres, não incluindo o terminador nulo.

Parameter4Value

[in] O valor do parâmetro 4.

Valor de retorno

StorPortEtwChannelEvent4 retorna um dos seguintes códigos de status:

Código de retorno	Descrição
STOR_STATUS_SUCCESS	O evento foi registrado com êxito.
STOR_STATUS_NOT_IMPLEMENTED	O rastreamento não está habilitado para eventos de armazenamento.
STOR_STATUS_INVALID_PARAMETER	Um dos parâmetros é inválido. Por exemplo, HwDeviceExtension ou EventDescription são NULL, EventDescription é maior que o tamanho máximo do nome ou um nome de parâmetro ETW é maior que o tamanho máximo do nome.

Observações

Um miniporto pode chamar StorPortEtwChannelEvent4 para registrar quatro parâmetros ETW de uso geral. Os parâmetros ETW são expressos como quatro pares nome-valor. Se um parâmetro não for nomeado (ParameterXName = NULL), a rotina definirá o valor do parâmetro correspondente como 0.

Os eventos gerados a partir de drivers de miniporto StorPort são registrados no canal especificado por EventChannel.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Windows 8.1
cabeçalho	storport.h

Consulte também

StorPortNvmeMiniportEvent

StorPortEtwChannelEvent2

StorPortEtwChannelEvent8

StorPortEtwEvent2

StorPortEtwEvent4

StorPortEtwEvent8

Partilhar via