Função StorPortEtwLogError (storport.h)
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 do dispositivo do miniporto.
[in, optional] Address
O endereço do dispositivo da unidade de armazenamento. Esse parâmetro é NULL para dispositivos adaptador.
[in] Id
Uma ID de evento definida pelo miniporto que identifica exclusivamente o evento.
[in] Description
O texto de descrição do erro. Esse parâmetro é necessário.
[in] DataBufferLength
Tamanho de 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.
Valor de retorno
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 | de 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. |
Observações
Um miniporto pode chamar StorPortEtwLogError para registrar um evento ETW em log para um erro de protocolo de hardware. Os eventos gerados a partir dessa função são publicados no canal ETW "Microsoft-Windows-Storage-Storport/Operational".
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Windows 10 versão 1903 |
| cabeçalho | storport.h |