Función StorPortEtwChannelEvent2 (storport.h)
Una miniporta llama a storPortEtwChannelEvent2 para registrar un evento ETW con dos parámetros ETW de uso general en un canal especificado.
Sintaxis
ULONG StorPortEtwChannelEvent2(
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
);
Parámetros
HwDeviceExtension
[in] Puntero a la extensión de dispositivo de hardware para el adaptador de bus host (HBA).
Address
[in/optional] Dirección del dispositivo de la unidad de almacenamiento. Este parámetro es NULL para dispositivos adaptadores.
EventChannel
[in] Valor de STORPORT_ETW_EVENT_CHANNEL que especifica el canal de Storport en el que se va a registrar el evento.
EventId
[in] Identificador definido por miniporte para identificar de forma única el tipo de evento.
EventDescription
[in] Cadena necesaria que describe el evento. El tamaño máximo de la cadena es STORPORT_ETW_MAX_DESCRIPTION_LENGTH caracteres, no incluido el terminador NULL.
EventKeywords
[in] 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. |
EventLevel
[in] Valor STORPORT_ETW_LEVEL que especifica la importancia o gravedad del evento.
EventOpcode
[in] Valor STORPORT_ETW_EVENT_OPCODE que especifica la naturaleza operativa del evento.
Srb
[in] Puntero a la SRB asociada al evento registrado. Si este parámetro contiene un SRB válido, se registran este puntero SRB y el puntero SRB asociado.
Parameter1Name
[in] Descripción del significado de Parameter1Value. El tamaño máximo de la cadena es STORPORT_ETW_MAX_PARAM_NAME_LENGTH caracteres, no incluido el terminador NULL.
Parameter1Value
[in] Valor del parámetro 1.
Parameter2Name
[in] Descripción del significado de Parameter2Value. El tamaño máximo de la cadena es STORPORT_ETW_MAX_PARAM_NAME_LENGTH caracteres, no incluido el terminador NULL.
Parameter2Value
[in] Valor del parámetro 2.
Valor devuelto
storPortEtwChannelEvent2 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. |
Observaciones
Un miniport puede llamar a storPortEtwChannelEvent2 para registrar dos parámetros ETW de uso general. Los parámetros ETW se expresan como dos 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 controladores de miniport storport se registran en el canal especificado por EventChannel.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 8.1 |
| encabezado de | storport.h |