FwpsNetBufferListAssociateContext0 함수(fwpsk.h)

  • 아티클

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

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

구문

NTSTATUS FwpsNetBufferListAssociateContext0(
  [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_FN0 notifyFn,
  [in]      UINT32                          flags
);

매개 변수

[in, out] netBufferList

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

[in] layerId

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

[in] context

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

[in] contextTag

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

providerGuid

공급자 GUID입니다.

[in, out] deviceObject

콜아웃 드라이버의 디바이스 개체에 대한 포인터입니다.

[in] notifyFn

콜아웃 드라이버에 대한 포인터 FWPS_NET_BUFFER_LIST_NOTIFY_FN0 함수입니다. 필터 엔진은 이 함수에 상태 알림을 보냅니다.

[in] flags

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

반환 값

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

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

설명

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

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

요구 사항

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

추가 정보

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRemoveContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

패킷 태그 지정 사용