Funzione StorPortEtwLogError (storport.h)

Articolo
02/26/2024

StorPortEtwLogError registra un evento ETW (Event Tracing for Windows) per un errore del protocollo hardware.

Sintassi

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

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo del miniport.

[in, optional] Address

Indirizzo del dispositivo dell'unità di archiviazione. Questo parametro è NULL per i dispositivi adattatori.

[in] Id

ID evento definito dal miniport che identifica in modo univoco l'evento.

[in] Description

Testo della descrizione per l'errore. Questo parametro è obbligatorio.

[in] DataBufferLength

Dimensioni di DataBuffer, in byte.

[in] DataBuffer

Buffer di dimensioni variabili che contiene dati binari specifici del driver utili per identificare la causa dell'errore. I driver devono specificare le dimensioni di questo buffer nel parametro DataBufferLength .

Valore restituito

Questa funzione restituisce uno dei codici di stato seguenti.

Codice restituito	Descrizione
STOR_STATUS_SUCCESS	L'evento è stato registrato correttamente.
STOR_STATUS_INVALID_PARAMETER	Descrizione o DataBuffer sono NULL oppure DataBufferLength non è maggiore di zero.
STOR_STATUS_UNSUCCESSFUL	StorPort non è riuscito a registrare l'evento ETW per altri motivi, ad esempio la registrazione ETW non è abilitata.

Commenti

Un miniport può chiamare StorPortEtwLogError per registrare un evento ETW per un errore del protocollo hardware. Gli eventi generati da questa funzione vengono pubblicati nel canale ETW "Microsoft-Windows-Storage-Storport/Operational".