Função StorPortEtwChannelEvent8 (storport.h)

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

Sintaxe

ULONG StorPortEtwChannelEvent8(
  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,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter5Name,
  ULONGLONG                                                    Parameter5Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter6Name,
  ULONGLONG                                                    Parameter6Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter7Name,
  ULONGLONG                                                    Parameter7Value,
  _In_reads_or_z_opt_(STORPORT_ETW_MAX_PARAM_NAME_LENGTH)PWSTR Parameter8Name,
  ULONGLONG                                                    Parameter8Value
);

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.

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.

Parameter5Name

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

Parameter5Value

[in] O valor do parâmetro 5.

Parameter6Name

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

Parameter6Value

[in] O valor do parâmetro 6.

Parameter7Name

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

Parameter7Value

[in] O valor do parâmetro 7.

Parameter8Name

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

Parameter8Value

[in] O valor do parâmetro 8.

Valor de retorno

StorPortEtwChannelEvent8 retorna um dos seguintes códigos de status:

Observações

Um miniporto pode chamar StorPortChannelEtwEvent8 para registrar oito parâmetros ETW de uso geral. Os parâmetros ETW são expressos como oito 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

Consulte também

StorPortNvmeMiniportEvent

StorPortEtwChannelEvent2

StorPortEtwChannelEvent4

StorPortEtwEvent2

StorPortEtwEvent4

StorPortEtwEvent8