Función StorPortEtwLogError (storport.h)

Artículo
02/29/2024

StorPortEtwLogError registra un evento de seguimiento de eventos para Windows (ETW) para un error de protocolo de hardware.

Sintaxis

ULONG StorPortEtwLogError(
  [in]           PVOID         HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS Address,
  [in]           ULONG         Id,
  [in]           PWSTR         Description,
  [in]           ULONG         DataBufferLength,
  [in]           PVOID         DataBuffer
);

Parámetros

[in] HwDeviceExtension

Puntero a la extensión del dispositivo del miniporte.

[in, optional] Address

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

[in] Id

Identificador de evento definido por miniporte que identifica de forma única el evento.

[in] Description

Texto de descripción del error. Este parámetro es obligatorio.

[in] DataBufferLength

Tamaño de DataBuffer, en bytes.

[in] DataBuffer

Un búfer de tamaño variable que contiene datos binarios específicos del controlador que resulta útil para identificar la causa del error. Los controladores deben especificar el tamaño de este búfer en el parámetro DataBufferLength .

Valor devuelto

Esta función devuelve uno de los siguientes códigos de estado.

Código devuelto	Descripción
STOR_STATUS_SUCCESS	El evento se registró correctamente.
STOR_STATUS_INVALID_PARAMETER	Descripción o DataBuffer son NULL o DataBufferLength no es mayor que cero.
STOR_STATUS_UNSUCCESSFUL	StorPort no pudo registrar el evento ETW por otros motivos, como el registro etw no está habilitado.

Comentarios

Un miniport puede llamar a StorPortEtwLogError para registrar un evento ETW para un error de protocolo de hardware. Los eventos generados a partir de esta función se publican en el canal ETW "Microsoft-Windows-Storage-Storport/Operational".