FLT_RELATED_OBJECTS 구조체(fltkernel.h)

아티클
02/26/2024

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

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

Filter

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

Volume

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

Instance

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

FileObject

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

Transaction

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

설명

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

FLT_RELATED_OBJECTS 구조체의 내용은 필터 관리자에 의해 설정됩니다. 미니필터 드라이버는 이 구조체의 내용을 직접 수정할 수 없습니다. 그러나 미니필터 드라이버가 작업의 FLT_IO_PARAMETER_BLOCK 구조에서 I/O 작업에 대한 대상 instance 또는 대상 파일 개체를 수정하는 경우 필터 관리자는 하위 미니필터 드라이버에 전달되는 FLT_RELATED_OBJECTS 구조체의 해당 Instance 또는 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;