FltGetTransactionContext 함수(fltkernel.h)

아티클
02/06/2025

FltGetTransactionContext 루틴은 지정된 미니 필터 드라이버에 의해 트랜잭션에 대해 설정된 컨텍스트를 검색합니다.

통사론

NTSTATUS FLTAPI FltGetTransactionContext(
  [in]  PFLT_INSTANCE Instance,
  [in]  PKTRANSACTION Transaction,
  [out] PFLT_CONTEXT  *Context
);

매개 변수

[in] Instance

호출자에 대한 불투명 인스턴스 포인터입니다.

[in] Transaction

컨텍스트가 검색되는 트랜잭션에 대한 불투명 트랜잭션 포인터입니다.

[out] Context

트랜잭션 컨텍스트의 주소를 받는 호출자 할당 변수에 대한 포인터입니다.

반환 값

FltGetTransactionContext STATUS_SUCCESS 또는 다음과 같은 적절한 NTSTATUS 값을 반환합니다.

반환 코드	묘사
STATUS_NOT_FOUND	일치하는 컨텍스트를 찾을 수 없습니다. 오류 코드입니다.

발언

컨텍스트에 대한 자세한 내용은 미니 필터 컨텍스트 정보참조하세요.

FltGetTransactionContextContext 매개 변수가 가리키는 컨텍스트에 대한 참조 수를 증분합니다. 이 컨텍스트 포인터가 더 이상 필요하지 않은 경우 호출자는 FltReleaseContext호출하여 참조 수를 줄여야 합니다. 따라서 FltGetTransactionContext 대한 모든 성공적인 호출은 FltReleaseContext대한 후속 호출과 일치해야 합니다.

트랜잭션에 대한 컨텍스트를 설정하려면 FltSetTransactionContext호출합니다.

새 트랜잭션 컨텍스트를 할당하려면 FltAllocateContext호출합니다.

트랜잭션 컨텍스트를 삭제하려면 FltDeleteTransactionContext 호출하거나 FltDeleteContext.