FLT_RELATED_OBJECTS 구조체(fltkernel.h)

아티클
02/06/2025

FLT_RELATED_OBJECTS 구조체에는 작업과 연결된 개체에 대한 불투명 포인터가 포함됩니다.

통사론

typedef struct _FLT_RELATED_OBJECTS {
  USHORT        Size;
  USHORT        TransactionContext;
  PFLT_FILTER   Filter;
  PFLT_VOLUME   Volume;
  PFLT_INSTANCE Instance;
  PFILE_OBJECT  FileObject;
  PKTRANSACTION Transaction;
} FLT_RELATED_OBJECTS, *PFLT_RELATED_OBJECTS;

회원

Size

FLT_RELATED_OBJECTS 구조체의 크기(바이트)입니다.

TransactionContext

Transaction 멤버가 NULL 않은 경우 트랜잭션 미니버전 ID 값을 포함하는 불투명 멤버입니다. Transaction NULL 경우 TransactionContext 값이 정의되지 않습니다.

Filter

작업에 대한 콜백 루틴이 호출되는 미니 필터 드라이버에 대한 불투명 필터 포인터입니다. 이 포인터는 미니 필터 드라이버를 고유하게 식별하고 미니 필터 드라이버가 로드되는 한 일정하게 유지됩니다.

Volume

작업과 연결된 볼륨에 대한 불투명 볼륨 포인터입니다. 이 포인터는 볼륨을 고유하게 식별하고 볼륨 디바이스 스택의 수명 동안 일정하게 유지됩니다.

Instance

작업과 연결된 미니 필터 드라이버 인스턴스에 대한 불투명 인스턴스 포인터입니다. 이 포인터는 인스턴스를 고유하게 식별하고 인스턴스가 볼륨에 연결된 한 일정하게 유지됩니다.

FileObject

작업에 대한 파일 개체(있는 경우)에 대한 포인터입니다.

Transaction

Windows Vista 이상에서 이 멤버는 작업과 연결된 트랜잭션에 대한 불투명 트랜잭션 포인터입니다. 이 멤버의 값이 NULL 않으면 작업이 트랜잭션의 일부가 됩니다. 이 멤버의 값이 NULL 경우 작업은 트랜잭션의 일부가 되지 않습니다. Windows Vista 이전의 Windows 운영 체제에서 이 멤버의 값은 항상 NULL .

발언

FLT_RELATED_OBJECTS 구조체는 필터 관리자에 의해 할당되며 I/O 작업 또는 인스턴스 설정 또는 해체 작업과 연결된 개체에 대한 불투명 포인터를 포함합니다.

FLT_RELATED_OBJECTS 구조체의 내용은 필터 관리자에 의해 설정됩니다. 미니 필터 드라이버는 이 구조의 내용을 직접 수정할 수 없습니다. 그러나 미니 필터 드라이버가 작업의 FLT_IO_PARAMETER_BLOCK 구조에서 I/O 작업에 대한 대상 인스턴스 또는 대상 파일 개체를 수정하는 경우 필터 관리자는 하위 미니 필터 드라이버에 전달되는 FLT_RELATED_OBJECTS 구조체의 해당 인스턴스 또는 FileObject 멤버의 값을 수정합니다. 자세한 내용은 I/O 작업대한 매개 변수 수정을 참조하세요.

미니 필터 드라이버는 FltObjects가 입력 매개 변수를 다음 콜백 루틴 형식으로 FLT_RELATED_OBJECTS 구조체에 대한 포인터를 받습니다.

PFLT_POST_OPERATION_CALLBACK

PFLT_PRE_OPERATION_CALLBACK

PFLT_INSTANCE_SETUP_CALLBACK

PFLT_INSTANCE_QUERY_TEARDOWN_CALLBACK

PFLT_INSTANCE_TEARDOWN_CALLBACK

FLT_RELATED_OBJECTS 구조체의 개체에 대한 미니 필터 드라이버의 컨텍스트에 대한 포인터를 검색하려면 FltGetContexts호출합니다.

참고typedef CONST struct _FLT_RELATED_OBJECTS *PCFLT_RELATED_OBJECTS;