Função StorPortEtwEvent4 (storport.h)
Um miniporto chama StorPortEtwEvent4 para registrar um evento ETW com quatro parâmetros ETW de uso geral em um canal de rastreamento de armazenamento.
Sintaxe
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
);
Parâmetros
[in] HwDeviceExtension
Um ponteiro para a extensão do dispositivo de hardware para o HBA (adaptador de barramento de host).
[in/optional] Address
O endereço do dispositivo da unidade de armazenamento. Esse parâmetro é NULL para dispositivos adaptador.
[in] EventId
Um identificador definido pelo miniporto para identificar exclusivamente o tipo de evento.
[in] EventDescription
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.
[in] EventKeywords
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. |
[in] EventLevel
Um valor STORPORT_ETW_LEVEL que especifica a importância ou a gravidade do evento.
[in] EventOpcode
Um valor STORPORT_ETW_EVENT_OPCODE que especifica a natureza operacional do evento.
[in/optional] Srb
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.
[in/optional] Parameter1Name
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.
[in] Parameter1Value
O valor do parâmetro 1.
[in/optional] Parameter2Name
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.
[in] Parameter2Value
O valor do parâmetro 2.
[in/optional] Parameter3Name
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.
[in] Parameter3Value
O valor do parâmetro 3.
[in/optional] Parameter4Name
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.
[in] Parameter4Value
O valor do parâmetro 4.
Valor de retorno
StorPortEtwEvent4 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 StorPortEtwEvent4 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 ETW "Microsoft-Windows-Storage-Storport/Diagnostic".
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 8.1 |
| da Plataforma de Destino | Universal |
| cabeçalho | storport.h (inclua Storport.h) |
| IRQL | <= DISPATCH_LEVEL |