struktur FILTER_INITIALIZATION_DATA (ntdddump.h)

Artikel
02/29/2024

Driver filter mengisi struktur FILTER_INITIALIZATION_DATA dan mengembalikannya ke driver crash dump.

Sintaks

typedef struct _FILTER_INITIALIZATION_DATA {
  ULONG        MajorVersion;
  ULONG        MinorVersion;
  PDUMP_START  DumpStart;
  PDUMP_WRITE  DumpWrite;
  PDUMP_FINISH DumpFinish;
  PDUMP_UNLOAD DumpUnload;
  PVOID        DumpData;
  ULONG        MaxPagesPerWrite;
  ULONG        Flags;
  PDUMP_READ   DumpRead;
} FILTER_INITIALIZATION_DATA, *PFILTER_INITIALIZATION_DATA;

Anggota

MajorVersion

Atur ke salah satu nilai versi utama berikut:

DUMP_FILTER_MAJOR_VERSION_1 (0x1)

DUMP_FILTER_MAJOR_VERSION (0x2)

MinorVersion

Atur ke DUMP_FILTER_MINOR_VERSION.

DumpStart

Penunjuk ke rutinitas inisialisasi cadangan. Rutinitas ini dipanggil ketika crash dump dimulai.

DumpWrite

Penunjuk ke rutinitas tulis. Rutinitas ini dipanggil sebelum setiap permintaan penulisan crash dump.

DumpFinish

Penunjuk ke rutinitas finish dump. Rutinitas ini dipanggil ketika crash dump selesai.

DumpUnload

Penunjuk ke rutinitas pembongkaran cadangan. Rutinitas ini dipanggil sebelum driver dibongkar.

DumpData

Driver filter dapat meneruskan pointer ke data konteks internal dalam anggota ini. Pointer ini diteruskan kembali ke driver filter dalam struktur FILTER_EXTENSION selama setiap panggilan balik.

MaxPagesPerWrite

Jumlah maksimum halaman untuk setiap permintaan baca atau tulis cadangan.

Flags

Sekumpulan bendera untuk inisialisasi filter cadangan. Nilai ini diatur ke 0 atau berikut ini:

Nilai	Makna
DUMP_FILTER_FLAG_SYSTEM_SUPPORT_READ	Filter cadangan mendukung pemfilteran baca, dan rutinitas panggilan balik baca diatur untuk DumpRead. Bendera ini didukung mulai dari Windows 8.
DUMP_FILTER_CRITICAL	Gagalkan inisialisasi filter segera jika rutinitas DriverEntry driver filter cadangan tidak mengembalikan STATUS_SUCCESS. Bendera ini didukung mulai dari Windows 8.