FWPS_NET_BUFFER_LIST_NOTIFY_FN0 콜백 함수(fwpsk.h)

아티클
02/26/2024

필터 엔진은 FWPS_NET_BUFFER_LIST_NOTIFY_FN0 설명선 함수를 호출하여 설명선 드라이버에 설명선에 의해 태그가 지정된 패킷과 연결된 이벤트에 대해 알립니다.

참고FWPS_NET_BUFFER_LIST_NOTIFY_FN0 Windows 7 이상에서 사용되는 특정 버전의 FWPS_NET_BUFFER_LIST_NOTIFY_FN . 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상 지정 을 참조하세요. Windows 8 경우 FWPS_NET_BUFFER_LIST_NOTIFY_FN1 사용할 수 있습니다.

구문

FWPS_NET_BUFFER_LIST_NOTIFY_FN0 FwpsNetBufferListNotifyFn0;

void FwpsNetBufferListNotifyFn0(
  [in]                FWPS_NET_BUFFER_LIST_EVENT_TYPE0 eventType,
  [in, out, optional] NET_BUFFER_LIST *netBufferList,
  [in, out, optional] NET_BUFFER_LIST *newNetBufferList,
  [in]                UINT16 layerId,
  [in]                UINT64 context,
  [in]                UINT64 contextTag
)
{...}

매개 변수

[in] eventType

필터 엔진이 콜아웃에 보내는 알림 유형을 나타내는 값입니다. 이 매개 변수는 의 값 중 하나로 설정됩니다. FWPS_NET_BUFFER_LIST_EVENT_TYPE0 열거형입니다.

[in, out, optional] netBufferList

이전에 설명선 드라이버에서 흥미로운 것으로 태그가 지정된 패킷이 포함된 버퍼 목록에 대한 포인터입니다.

[in, out, optional] newNetBufferList

설명선 드라이버에 흥미로운 패킷이 포함된 업데이트된 버퍼 목록에 대한 포인터입니다. 이 매개 변수의 사용은 이벤트 유형에 따라 다릅니다. 표시된 패킷을 변경하는 이벤트의 경우 변경된 버전이 이 매개 변수로 전달됩니다.

[in] layerId

알림 함수가 호출된 계층입니다.

[in] context

관심 있는 패킷에 태그를 지정하는 데 사용되는 컨텍스트입니다. 이 값은 콜아웃 드라이버가 패킷에 할당한 값이며 패킷을 식별하는 데 사용됩니다.

[in] contextTag

관심 있는 패킷을 설명선 드라이버의 컨텍스트와 연결하는 데 사용되는 컨텍스트 태그입니다.

반환 값

없음

설명

이 함수는 호출을 통해 콜아웃 드라이버와 연결됩니다. FwpsNetBufferListAssociateContext0. 설명선 드라이버는 단일 알림 함수를 사용하여 컨텍스트 및 컨텍스트 태그를 사용하여 여러 연결된 버퍼 목록에 대한 메시지를 처리하여 인스턴스를 구분할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 7부터 사용할 수 있습니다.
대상 플랫폼	Windows
헤더	fwpsk.h(Fwpsk.h 포함)
IRQL	<= DISPATCH_LEVEL