Fungsi StorPortLogTelemetry (storport.h)

  • Artikel

StorPortLogTelemetry mencatat peristiwa telemetri miniport untuk membantu mendiagnosis atau mengumpulkan informasi yang berguna. Miniport dapat mencatat delapan pasangan nama-nilai tujuan umum dan buffer yang memiliki panjang maksimum 4KB, serta beberapa bidang terkait peristiwa yang didefinisikan dalam struktur STORPORT_TELEMETRY_EVENT.

Sintaks

ULONG StorPortLogTelemetry(
  [in]           PVOID                     HwDeviceExtension,
  [in, optional] PSTOR_ADDRESS             StorAddress,
  [in]           PSTORPORT_TELEMETRY_EVENT Event
);

Parameter

[in] HwDeviceExtension

Pointer ke ekstensi perangkat keras untuk adaptor bus host (HBA).

[in, optional] StorAddress

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

[in] Event

Arahkan ke struktur STORPORT_TELEMETRY_EVENT yang berisi payload data telemetri.

Nilai kembali

StorPortLogTelemetry mengembalikan salah satu kode status berikut:

Menampilkan kode Deskripsi
STOR_STATUS_INVALID_BUFFER_SIZE
 EventBufferLength lebih besar dari EVENT_BUFFER_MAX_LENGTH.
STOR_STATUS_INVALID_PARAMETER
 Penunjuk ke salah satu parameter adalah NULL atau EventBufferLength/EventBuffer dalam Struktur peristiwa tidak cocok.
STOR_STATUS_NOT_IMPLEMENTED
 Fungsi ini tidak diimplementasikan pada sistem operasi aktif.
STATUS_SUCCESS
 Data peristiwa telemetri telah berhasil dicatat.

Keterangan

Jika ada parameter dalam struktur Peristiwa yang tidak bernama, Event-ParameterNameX> == NULL, rutinitas akan mengatur nilai parameter yang sesuai ke 0.

Jika miniport tidak memiliki payload untuk mengisi Event-EventBuffer>, miniport harus mengatur Event-EventBufferLength> = 0, serta Event-EventBuffer> = NULL.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 10, versi 1703
Server minimum yang didukung Server Windows 2016
Target Platform Windows
Header storport.h (termasuk Storport.h)
IRQL Apa pun

Lihat juga

STORPORT_TELEMETRY_EVENT

StorPortLogTelemetryEx