Fungsi StorPortEtwLogError (storport.h)

Artikel
02/29/2024

StorPortEtwLogError mencatat peristiwa Pelacakan Peristiwa untuk Windows (ETW) untuk kesalahan protokol perangkat keras.

Sintaks

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

Penunjuk ke ekstensi perangkat miniport.

[in, optional] Address

Alamat perangkat unit penyimpanan. Parameter ini NULL untuk perangkat adaptor.

[in] Id

ID peristiwa yang ditentukan miniport yang mengidentifikasi peristiwa secara unik.

[in] Description

Teks deskripsi untuk kesalahan. Parameter ini diperlukan.

[in] DataBufferLength

Ukuran DataBuffer, dalam byte.

[in] DataBuffer

Buffer ukuran variabel yang berisi data biner khusus driver yang berguna dalam mengidentifikasi penyebab kesalahan. Driver harus menentukan ukuran buffer ini dalam parameter DataBufferLength .

Mengembalikan nilai

Fungsi ini mengembalikan salah satu kode status berikut.

Menampilkan kode	Deskripsi
STOR_STATUS_SUCCESS	Kejadian berhasil dicatat.
STOR_STATUS_INVALID_PARAMETER	Deskripsi atau DataBuffer adalah NULL, atau DataBufferLength tidak lebih besar dari nol.
STOR_STATUS_UNSUCCESSFUL	StorPort tidak dapat mencatat peristiwa ETW karena alasan lain, seperti pengelogan ETW tidak diaktifkan.

Keterangan

Miniport dapat memanggil StorPortEtwLogError untuk mencatat peristiwa ETW untuk kesalahan protokol perangkat keras. Peristiwa yang dihasilkan dari fungsi ini diterbitkan ke saluran ETW "Microsoft-Windows-Storage-Storport/Operational".