StorPortEtwLogError-Funktion (storport.h)

Artikel
03/05/2024

StorPortEtwLogError protokolliert ein ETW-Ereignis (Event Tracing for Windows) auf einen Hardwareprotokollfehler.

Syntax

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

Parameter

[in] HwDeviceExtension

Ein Zeiger auf die Geräteerweiterung des Miniports.

[in, optional] Address

Die Geräteadresse der Speichereinheit. Dieser Parameter ist NULL für Adaptergeräte.

[in] Id

Eine durch Miniport definierte Ereignis-ID, die das Ereignis eindeutig identifiziert.

[in] Description

Der Beschreibungstext für den Fehler. Dieser Parameter ist erforderlich.

[in] DataBufferLength

Größe von DataBuffer in Bytes.

[in] DataBuffer

Ein Puffer mit variabler Größe, der treiberspezifische Binärdaten enthält, die bei der Identifizierung der Fehlerursache nützlich sind. Treiber müssen die Größe dieses Puffers im DataBufferLength-Parameter angeben.

Rückgabewert

Diese Funktion gibt einen der folgenden status Codes zurück.

Rückgabecode	Beschreibung
STOR_STATUS_SUCCESS	Das Ereignis wurde erfolgreich protokolliert.
STOR_STATUS_INVALID_PARAMETER	Beschreibung oder DataBuffer sind NULL, oder DataBufferLength ist nicht größer als 0.
STOR_STATUS_UNSUCCESSFUL	StorPort konnte das ETW-Ereignis aus anderen Gründen nicht protokollieren, z. B. weil die ETW-Protokollierung nicht aktiviert ist.

Hinweise

Ein Miniport kann StorPortEtwLogError aufrufen, um ein ETW-Ereignis für einen Hardwareprotokollfehler zu protokollieren. Aus dieser Funktion generierte Ereignisse werden im ETW-Kanal "Microsoft-Windows-Storage-Storport/Operational" veröffentlicht.