FwpsNetBufferListRemoveContext0 함수(fwpsk.h)

  • 아티클

FwpsNetBufferListRemoveContext0 함수는 네트워크 버퍼 목록과 연결된 컨텍스트를 제거합니다.

참고FwpsNetBufferListRemoveContext0 은 특정 버전의 FwpsNetBufferListRemoveContext입니다. 자세한 내용은 WFP Version-Independent 이름 및 특정 버전의 Windows 대상 지정 을 참조하세요.
 

구문

NTSTATUS FwpsNetBufferListRemoveContext0(
  [in, out, optional] NET_BUFFER_LIST *netBufferList,
  [in]                UINT64          contextTag,
  [in]                UINT32          flags
);

매개 변수

[in, out, optional] netBufferList

설명선 드라이버에 대한 관심 패킷을 하나 이상 나타내는 네트워크 버퍼 목록입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다. NULL인 경우 함수는 연결된 모든 네트워크 버퍼 목록에서 컨텍스트를 제거합니다.

[in] contextTag

contextTag 매개 변수에서 FwpsNetBufferListAssociateContext0에 전달된 컨텍스트 태그입니다.

[in] flags

이 매개 변수는 나중에 사용하도록 예약되어 있으며 0이어야 합니다.

반환 값

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

반환 코드 설명
STATUS_SUCCESS
 컨텍스트가 성공적으로 제거되었습니다.
기타 상태 코드
 오류가 발생했습니다.

설명

FwpsNetBufferListRemoveContext0 함수는 네트워크 버퍼 목록과 연결된 태그가 지정된 컨텍스트를 비동기적으로 제거합니다.

컨텍스트를 네트워크 버퍼 목록과 연결하려면 를 호출합니다. FwpsNetBufferListAssociateContext0 또는 FwpsNetBufferListAssociateContext1.

일반적으로 설명선 드라이버는 패킷이 스택을 통과할 때 태그가 지정된 컨텍스트가 자동으로 제거되므로 이 함수를 사용할 필요가 없습니다. 이 함수는 컨텍스트가 자동으로 제거되지 않는 상황에서 설명선 드라이버가 처리를 중지할 수 있도록 제공됩니다. 예를 들어 NDIS 필터 드라이버의 경우 패킷은 TCP/IP 스택에 들어가지 않으며 netBufferList 매개 변수가 NULL로 설정된 FwpsNetBufferListRemoveContext0을 호출하여 컨텍스트를 수동으로 제거해야 합니다.

요구 사항

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

추가 정보

FwpsNetBufferListAssociateContext0

FwpsNetBufferListAssociateContext1

FwpsNetBufferListGetTagForContext0 FwpsNetBufferListRetrieveContext0

NET_BUFFER_LIST

패킷 태그 지정 사용