Función StorPortEtwEvent8 (storport.h)
Una miniporta llama a StorPortEtwEvent8 para registrar un evento 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 de dispositivo de hardware para el adaptador de bus host (HBA).
[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 identificar de forma única el tipo de evento.
[in] EventDescription
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.
[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
Valor STORPORT_ETW_LEVEL que especifica la importancia o gravedad del evento.
[in] EventOpcode
Valor STORPORT_ETW_EVENT_OPCODE que especifica la naturaleza operativa del evento.
[in/optional] Srb
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.
[in/optional] Parameter1Name
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.
[in] Parameter1Value
Valor del parámetro 1.
[in/optional] Parameter2Name
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.
[in] Parameter2Value
Valor del parámetro 2.
[in/optional] Parameter3Name
Descripción del significado de Parameter3Value. El tamaño máximo de la cadena es STORPORT_ETW_MAX_PARAM_NAME_LENGTH caracteres, no incluido el terminador NULL.
[in] Parameter3Value
Valor del parámetro 3.
[in/optional] Parameter4Name
Descripción del significado de Parameter4Value. El tamaño máximo de la cadena es STORPORT_ETW_MAX_PARAM_NAME_LENGTH caracteres, no incluido el terminador NULL.
[in] Parameter4Value
Valor del parámetro 4.
[in/optional] Parameter5Name
Descripción del significado de Parameter5Value. El tamaño máximo de la cadena es STORPORT_ETW_MAX_PARAM_NAME_LENGTH caracteres, no incluido el terminador NULL.
[in] Parameter5Value
Valor del parámetro 5.
[in/optional] Parameter6Name
Descripción del significado de Parameter6Value. El tamaño máximo de la cadena es STORPORT_ETW_MAX_PARAM_NAME_LENGTH caracteres, no incluido el terminador NULL.
[in] Parameter6Value
Valor del parámetro 6.
[in/optional] Parameter7Name
Descripción del significado de Parameter7Value. El tamaño máximo de la cadena es STORPORT_ETW_MAX_PARAM_NAME_LENGTH caracteres, no incluido el terminador NULL.
[in] Parameter7Value
Valor del parámetro 7.
[in/optional] Parameter8Name
Descripción del significado de Parameter8Value. El tamaño máximo de la cadena es STORPORT_ETW_MAX_PARAM_NAME_LENGTH caracteres, no incluido el terminador NULL.
[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. |
Observaciones
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".
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 8.1 |
| de la plataforma de destino de | Universal |
| encabezado de | storport.h (incluya Storport.h) |
| irQL | <= DISPATCH_LEVEL |