FILTER_INITIALIZATION_DATA 구조체(ntdddump.h)

아티클
02/06/2022
읽는 데 3분 걸림

필터 드라이버는 FILTER_INITIALIZATION_DATA 구조를 채우고 크래시 덤프 드라이버에 반환합니다.

구문

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;

구성원

MajorVersion

다음 주 버전 값 중 하나로 설정합니다.

DUMP_FILTER_MAJOR_VERSION_1(0x1)

DUMP_FILTER_MAJOR_VERSION(0x2)

MinorVersion

DUMP_FILTER_MINOR_VERSION.

DumpStart

덤프 초기화 루틴에 대한 포인터입니다. 이 루틴은 크래시 덤프가 시작될 때 호출됩니다.

DumpWrite

쓰기 루틴에 대한 포인터입니다. 이 루틴은 모든 크래시 덤프 쓰기 요청 전에 호출됩니다.

DumpFinish

덤프 완료 루틴에 대한 포인터입니다. 이 루틴은 크래시 덤프가 완료되면 호출됩니다.

DumpUnload

덤프 언로드 루틴에 대한 포인터입니다. 이 루틴은 드라이버가 언로드되기 전에 호출됩니다.

DumpData

필터 드라이버는 이 멤버의 내부 컨텍스트 데이터에 대한 포인터를 전달할 수 있습니다. 이 포인터는 각 콜백 중에 FILTER_EXTENSION 구조의 필터 드라이버에 다시 전달됩니다.

MaxPagesPerWrite

각 덤프 읽기 또는 쓰기 요청에 대한 최대 페이지 수입니다.

Flags

덤프 필터 초기화를 위한 플래그 집합입니다. 이 값은 0 또는 다음으로 설정됩니다.

값	의미
DUMP_FILTER_FLAG_SYSTEM_SUPPORT_READ	덤프 필터는 읽기 필터링을 지원하며 DumpRead에 대한 읽기 콜백 루틴이 설정됩니다. 이 플래그는 Windows 8부터 지원됩니다.
DUMP_FILTER_CRITICAL	덤프 필터 드라이버의 DriverEntry 루틴이 STATUS_SUCCESS 반환하지 않으면 필터 초기화에 즉시 실패합니다. 이 플래그는 Windows 8부터 지원됩니다.