Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Um miniporto chama StorPortEtwEvent8 para registrar um evento ETW com oito parâmetros ETW de uso geral em um canal de rastreamento de armazenamento.
Sintaxe
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
);
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.
[in/optional] Parameter5Name
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.
[in] Parameter5Value
O valor do parâmetro 5.
[in/optional] Parameter6Name
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.
[in] Parameter6Value
O valor do parâmetro 6.
[in/optional] Parameter7Name
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.
[in] Parameter7Value
O valor do parâmetro 7.
[in/optional] Parameter8Name
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.
[in] Parameter8Value
O valor do parâmetro 8.
Valor de retorno
StorPortEtwEvent8 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 StorPortEtwEvent8 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 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 |