다음을 통해 공유

FWPS_CALLOUT_CLASSIFY_FN3 콜백 함수(fwpsk.h)

  • 아티클

설명선 필터가 일치할 때 분류 중에 호출되는 콜백 함수의 버전 3입니다. 차이점은 이 콜백이 FWPS_FILTER3 구조를 반환한다는 것입니다.

통사론

FWPS_CALLOUT_CLASSIFY_FN3 FwpsCalloutClassifyFn3;

void FwpsCalloutClassifyFn3(
  const FWPS_INCOMING_VALUES0 *inFixedValues,
  const FWPS_INCOMING_METADATA_VALUES0 *inMetaValues,
  void *layerData,
  const void *classifyContext,
  const FWPS_FILTER3 *filter,
  UINT64 flowContext,
  FWPS_CLASSIFY_OUT0 *classifyOut
)
{...}

매개 변수

inFixedValues

FWPS_INCOMING_VALUES0 구조체에 대한 포인터입니다. 이 구조에는 필터링되는 계층의 각 데이터 필드에 대한 값이 포함됩니다.

inMetaValues

FWPS_INCOMING_METADATA_VALUES0 구조체에 대한 포인터입니다. 이 구조에는 필터링되는 계층의 각 메타데이터 필드에 대한 값이 포함됩니다.

layerData

필터링되는 계층의 원시 데이터를 설명하는 구조체에 대한 포인터입니다. 이 매개 변수는 필터링되는 계층과 classifyFn3 설명선 함수가 호출되는 조건에 따라 NULL수 있습니다. 스트림 계층의 경우 이 매개 변수는 FWPS_STREAM_CALLOUT_IO_PACKET0 구조를 가리킵니다. 다른 모든 계층의 경우 이 매개 변수는 NULL않으면 NET_BUFFER_LIST 구조를 가리킵니다.

classifyContext

필터 엔진에서 설명선 드라이버와 연결된 컨텍스트 데이터에 대한 포인터입니다.

filter

FWPS_FILTER3 구조체에 대한 포인터입니다. 이 구조는 필터 작업에 대한 설명선 지정 필터를 설명합니다.

flowContext

데이터 흐름과 연결된 컨텍스트를 포함하는 UINT64 형식의 변수입니다. 데이터 흐름과 연결된 컨텍스트가 없는 경우 이 매개 변수는 0입니다. 데이터 흐름을 지원하지 않는 필터링 계층의 필터 엔진에 설명선이 추가되면 classifyFn3 설명선 함수는 이 매개 변수를 무시해야 합니다.

classifyOut

classifyFn3 설명선 함수가 호출자에게 반환하는 모든 데이터를 수신하는 FWPS_CLASSIFY_OUT0 구조체에 대한 포인터입니다.

반환 값

없음

발언

설명선 드라이버는 FwpsCalloutRegister2 함수를 호출하여 설명선의 설명선 함수를 필터 엔진에 등록합니다.

필터 엔진은 필터 작업에 대한 설명선이 지정된 필터 엔진의 필터에 대해 모든 테스트 조건이 충족될 때마다 처리할 데이터가 있는 설명선의 classifyFn3 설명선 함수를 호출합니다.

설명선의 classifyFn1 설명선 함수는 다음 상황에서 FWPS_CLASSIFY_OUT0 구조의 멤버를 권한의 FWPS_RIGHT_ACTION_WRITE 플래그를 지워야 합니다.

  • classifyFn1 설명선 함수가 FWPS_CLASSIFY_OUT0 구조체의 actionType 멤버를 FWP_ACTION_BLOCK설정합니다.
  • classifyFn1 설명선 함수가 FWPS_CLASSIFY_OUT0 구조체의 actionType 멤버를 FWP_ACTION_PERMIT 설정하면 FWPS_FILTER_FLAG_CLEAR_ACTION_RIGHT 플래그가 FWPS_FILTER3 구조체의 플래그 멤버에 설정됩니다.
  • 설명선에서 FwpsReferenceNetBufferList0 함수에 대한 호출에서 intendToModify 매개 변수를 TRUE 설정하여 복제 순 버퍼 목록을 수정하려는 것으로 표시되면.

요구 사항

요구 값
지원되는 최소 클라이언트 Windows Vista부터 사용할 수 있습니다.
헤더 fwpsk.h
IRQL <= DISPATCH_LEVEL

참고 항목