Fungsi StorPortCaptureLiveDump (storport.h)

Artikel
02/26/2024

StorPortCaptureLiveDump mengambil file cadangan langsung.

Sintaks

ULONG StorPortCaptureLiveDump(
  [in]          PVOID                      HwDeviceExtension,
  [in/optional] PSTOR_ADDRESS              StorAddress,
  [in]          PSTORPORT_CAPTURE_LIVEDUMP CaptureLivedump
);

Parameter

[in] HwDeviceExtension

Arahkan ke ekstensi perangkat keras miniport.

[in/optional] StorAddress

Penunjuk ke struktur STOR_ADDRESS yang menyimpan alamat yang menentukan objek unit. Atur StorAddress ke NULL jika perangkat adalah adaptor.

[in] CaptureLivedump

Penunjuk ke struktur STORPORT_CAPTURE_LIVEDUMP yang berisi data yang diperlukan untuk menghasilkan cadangan langsung.

Nilai kembali

StorPortCaptureLiveDump mengembalikan salah satu nilai berikut:

Menampilkan kode	Deskripsi
STOR_STATUS_SUCCESS	Daftar fitur cadangan berhasil disetel.
STOR_STATUS_INVALID_PARAMETER	Satu atau beberapa parameter yang disediakan tidak valid.
STOR_STATUS_UNSUCCESSFUL	Dikembalikan karena alasan sistem internal lainnya.

Keterangan

Ketika miniport mendeteksi masalah yang mungkin memerlukan triase lebih lanjut, miniport dapat memanggil StorPortCaptureLiveDump untuk mengambil file cadangan langsung.

Fungsi ini harus dipanggil pada PASSIVE_LEVEL.