FwpsNetBufferListAssociateContext1 함수(fwpsk.h)

FwpsNetBufferListAssociateContext1 함수는 설명선 드라이버의 컨텍스트를 네트워크 버퍼 목록과 연결하고 네트워크 버퍼 목록 이벤트에 대한 알림을 구성합니다.

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

 

통사론

NTSTATUS FwpsNetBufferListAssociateContext1(
  [in, out] NET_BUFFER_LIST                 *netBufferList,
  [in]      UINT16                          layerId,
  [in]      UINT64                          context,
  [in]      UINT64                          contextTag,
            GUID                            *providerGuid,
  [in, out] void                            *deviceObject,
  [in]      FWPS_NET_BUFFER_LIST_NOTIFY_FN1 notifyFn,
  [in]      UINT32                          flags
);

매개 변수

[in, out] netBufferList

설명선 드라이버에 대한 하나 이상의 관심 패킷을 나타내는 네트워크 버퍼 목록입니다.

[in] layerId

컨텍스트가 연결된 계층의 식별자입니다. NDIS 수신 경로에서 이 함수를 호출할 때 이 매개 변수를 FWPS_LAYER_NON_WFP설정합니다.

[in] context

설명선 드라이버에서 설정한 임의 컨텍스트 정보입니다. 필터 엔진은 이 컨텍스트를 설명선 드라이버에 전달합니다.
FWPS_NET_BUFFER_LIST_NOTIFY_FN1 함수입니다.

[in] contextTag

를 호출하여 얻은 로컬 고유 식별자 FwpsNetBufferListGetTagForContext0 함수입니다.

providerGuid

공급자 GUID입니다.

[in, out] deviceObject

설명선 드라이버의 디바이스 개체에 대한 포인터입니다.

[in] notifyFn

설명선 드라이버의 FWPS_NET_BUFFER_LIST_NOTIFY_FN1 함수에 대한 포인터입니다. 필터 엔진은 이 함수에 상태 알림을 보냅니다.

[in] flags

이 매개 변수는 나중에 사용할 수 있도록 예약되어 있으며 0으로 설정됩니다.

반환 값

FwpsNetBufferListAssociateContext1 함수는 다음 NTSTATUS 코드 중 하나를 반환합니다.

반환 코드	묘사
STATUS_SUCCESS	연결이 성공했습니다.
기타 상태 코드	오류가 발생했습니다.

발언

FwpsNetBufferListAssociateContext1 함수는 패킷 그룹을 설명선 드라이버와 연결합니다. 스택의 여러 계층을 통해 검사를 위해 관심 패킷을 추적할 수 있습니다.

이 함수를 호출하기 전에 FwpsNetBufferListGetTagForContext0 함수를 호출하여 컨텍스트 태그를 가져와야 합니다.

이 함수는 기본적으로 이전 버전과 동일합니다.

FwpsNetBufferListAssociateContext0 . 유일한 차이점은 notifyFn 매개 변수가 가리키는 업데이트된 FWPS_NET_BUFFER_LIST_NOTIFY_FN1 함수입니다.

요구 사항

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

참고 항목

FWPS_NET_BUFFER_LIST_NOTIFY_FN1

FwpsNetBufferListAssociateContext0

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

패킷 태그 지정 사용하여