Fungsi StorPortMarkDumpMemory (storport.h)

  • Artikel

Miniport harus menandai memori yang digunakan untuk file cadangan atau file hibernasi. Memori yang ditandai dipertahankan dan tetap valid setelah melanjutkan dari operasi hibernasi. Memori yang akan ditandai ditentukan oleh alamat dan panjang rentang dalam panggilan ke StorPortMarkDumpMemory.

Sintaks

ULONG StorPortMarkDumpMemory(
  [in] PVOID     HwDeviceExtension,
  [in] PVOID     Address,
  [in] ULONG_PTR Length,
  [in] ULONG     Flags
);

Parameter

[in] HwDeviceExtension

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

[in] Address

Alamat awal rentang memori yang akan ditandai.

[in] Length

Panjang rentang memori yang ditandai.

[in] Flags

Buang bendera penandaan memori. Parameter Bendera harus 0 atau hanya berisi nilai berikut.

Nilai Makna
MARK_DUMP_MEMORY_FLAG_PHYSICAL_ADDRESS Alamat yang disediakan di Alamat adalah alamat fisik dan bukan alamat virtual sistem.

Mengembalikan nilai

StorPortMarkDumpMemory mengembalikan salah satu kode status berikut:

Menampilkan kode Deskripsi
STOR_STATUS_SUCCESS Menunjukkan bahwa rutinitas berhasil mengatur atribut unit.
STOR_STATUS_INVALID_PARAMETER Nilai bendera yang tidak valid ditentukan dalam parameter Bendera .

Keterangan

Rutinitas StorPortMarkDumpMemory hanya boleh dipanggil oleh driver miniport dalam rutinitas DriverEntry atau HwStorFindAdapter - nya.

Jika Panjang = 0, seluruh bagian yang berisi Alamat ditandai.

Driver miniport harus memanggil StorPortMarkDumpMemory untuk memastikan bahwa memori yang digunakan oleh miniport untuk menghasilkan file cadangan atau file hibernasi diidentifikasi. Minimal, miniport harus memanggil StorPortMarkDumpMemory ketika anggota DumpModePORT_CONFIGURATION_INFORMATION diatur ke DUMP_MODE_MARK_MEMORY atau DUMP_MODE_HIBER.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows 8
Target Platform Universal
Header storport.h (termasuk Storport.h)
IRQL Apa pun

Lihat juga

DriverEntry

HwStorFindAdapter

PORT_CONFIGURATION_INFORMATION