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

패킷 태그 지정 사용