Función StorPortEtwEvent8 (storport.h)

Artículo
08/07/2023

StorPortEtwEvent8 registra un evento de seguimiento de eventos para Windows (ETW) con ocho parámetros ETW de uso general en un canal de seguimiento de almacenamiento.

Sintaxis

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

Puntero a la extensión del dispositivo de la minipuerto.

[in, optional] Address

Dirección del dispositivo de la unidad de almacenamiento. Este parámetro es NULL para dispositivos adaptadores.

[in] EventId

Identificador definido por miniporte para el evento ETW.

[in] EventDescription

Texto de descripción del evento. Esta cadena de texto debe ser <= STORPORT_ETW_MAX_DESCRIPTION_LENGTH.

[in] EventKeywords

Marcas de palabra clave para la categorización de eventos. Establezca en 0 si no se desea ninguna palabra clave. Las palabras clave son una combinación OR bit a bit de lo siguiente.

Valor	Significado
STORPORT_ETW_EVENT_KEYWORD_IO	El evento está relacionado con las operaciones de E/S del dispositivo.
STORPORT_ETW_EVENT_KEYWORD_PERFORMANCE	El evento está relacionado con el rendimiento.
STORPORT_ETW_EVENT_KEYWORD_POWER	El evento está relacionado con la alimentación del dispositivo.
STORPORT_ETW_EVENT_KEYWORD_ENUMERATION	El evento está relacionado con la enumeración de dispositivos.

[in] EventLevel

Nivel de evento. Este valor puede indicar la importancia o gravedad del evento. Se trata de uno de los siguientes valores.

Valor	Significado
StorportEtwLevelLogAlways	Registre el evento incondicionalmente. El evento se registra independientemente de los filtros establecidos.
StorportEtwLevelCritical	Evento de nivel crítico.
StorportEtwLevelError	Evento de nivel de error.
StorportEtwLevelWarning	Evento de nivel de advertencia.
StorportEtwLevelInformational	Evento informativo.
StorportEtwLevelVerbose	Información detallada del evento proporcionada.

[in] EventOpcode

Naturaleza operativa del evento. Se trata de uno de los siguientes valores.

Valor	Significado
StorportEtwEventOpcodeInfo	Evento informativo general.
StorportEtwEventOpcodeStart	El dispositivo o la unidad se estaba iniciando.
StorportEtwEventOpcodeStop	El dispositivo o la unidad se detenía. El evento corresponde al último evento de inicio no emparejado.
StorportEtwEventOpcodeDC_Start	Evento de inicio de recopilación de datos. Estos son tipos de eventos de ejecución.
StorportEtwEventOpcodeDC_Stop	Evento de detención de recopilación de datos. Estos son tipos de eventos de ejecución.
StorportEtwEventOpcodeExtension	Evento de extensión.
StorportEtwEventOpcodeReply	Evento de respuesta.
StorportEtwEventOpcodeResume	El dispositivo o la unidad se reanudó después de la suspensión.
StorportEtwEventOpcodeSuspend	El dispositivo o la unidad se suspenden pendientes de finalización de otra operación.
StorportEtwEventOpcodeReceive	La transferencia de actividad se recibe de otro componente.

[in, optional] Srb

Puntero al SRB asociado al evento registrado. Si este parámetro contiene un SRB válido, se registran este puntero SRB y el puntero SRB asociado.

[in, optional] Parameter1Name

Descripción del significado de Parameter1Value. Esta cadena de nombre de parámetro debe ser <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.

[in] Parameter1Value

Valor del parámetro 1.

[in, optional] Parameter2Name

Descripción del significado de Parameter2Value. Esta cadena de nombre de parámetro debe ser <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.

[in] Parameter2Value

Valor del parámetro 2.

[in, optional] Parameter3Name

Descripción del significado de Parameter3Value. Esta cadena de nombre de parámetro debe ser <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.

[in] Parameter3Value

Valor del parámetro 3.

[in, optional] Parameter4Name

Descripción del significado de Parameter4Value. Esta cadena de nombre de parámetro debe ser <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.

[in] Parameter4Value

Valor del parámetro 4.

[in, optional] Parameter5Name

Descripción del significado de Parameter5Value. Esta cadena de nombre de parámetro debe ser <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.

[in] Parameter5Value

Valor del parámetro 5.

[in, optional] Parameter6Name

Descripción del significado de Parameter6Value. Esta cadena de nombre de parámetro debe ser <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.

[in] Parameter6Value

Valor del parámetro 6.

[in, optional] Parameter7Name

Descripción del significado de Parameter7Value. Esta cadena de nombre de parámetro debe ser <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.

[in] Parameter7Value

Valor del parámetro 7.

[in, optional] Parameter8Name

Descripción del significado de Parameter8Value. Esta cadena de nombre de parámetro debe ser <= STORPORT_ETW_MAX_PARAM_NAME_LENGTH.

[in] Parameter8Value

Valor del parámetro 8.

Valor devuelto

StorPortEtwEvent8 devuelve uno de los siguientes códigos de estado:

Código devuelto	Descripción
STOR_STATUS_SUCCESS	El evento se registró correctamente.
STOR_STATUS_NOT_IMPLEMENTED	El seguimiento no está habilitado para eventos de almacenamiento.
STOR_STATUS_INVALID_PARAMETER	Uno de los parámetros no es válido. Por ejemplo, HwDeviceExtension o EventDescription son NULL, EventDescription es mayor que la longitud máxima del nombre o un nombre de parámetro ETW es mayor que la longitud máxima del nombre.

Comentarios

Un miniport puede llamar a StorPortEtwEvent8 para registrar ocho parámetros ETW de uso general. Los parámetros ETW se expresan como ocho pares nombre-valor. Si no se llama a un parámetro (ParameterXName = NULL), la rutina establecerá el valor de parámetro correspondiente en 0.

Los eventos generados a partir de los controladores de miniport StorPort se registran en el canal ETW "Microsoft-Windows-Storage-Storport/Diagnostic".