Função StorPortEtwLogError (storport.h)

Artigo
02/27/2024

StorPortEtwLogError registra um evento ETW (Rastreamento de Eventos para Windows) para um erro de protocolo de hardware.

Sintaxe

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

Um ponteiro para a extensão de dispositivo do miniporto.

[in, optional] Address

O endereço do dispositivo da unidade de armazenamento. Esse parâmetro é NULL para dispositivos de adaptador.

[in] Id

Uma ID de evento definida pelo miniporto que identifica exclusivamente o evento.

[in] Description

O texto de descrição do erro. Este parâmetro é necessário.

[in] DataBufferLength

Tamanho do DataBuffer, em bytes.

[in] DataBuffer

Um buffer de tamanho variável que contém dados binários específicos do driver que são úteis para identificar a causa do erro. Os drivers devem especificar o tamanho desse buffer no parâmetro DataBufferLength .

Retornar valor

Essa função 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_INVALID_PARAMETER	Descrição ou DataBuffer são NULL ou DataBufferLength não é maior que zero.
STOR_STATUS_UNSUCCESSFUL	O StorPort não pôde registrar o evento ETW por outros motivos, como o registro em log etw não está habilitado.

Comentários

Um miniporto pode chamar StorPortEtwLogError para registrar um evento ETW em um erro de protocolo de hardware. Os eventos gerados com base nessa função são publicados no canal ETW "Microsoft-Windows-Storage-Storport/Operational".