피드백

FwpsvSwitchEventsSubscribe0 함수(fwpsk.h)

  • 아티클
  • 읽는 데 2분 걸림

FwpsvSwitchEventsSubscribe0 함수는 가상 포트 만들기 및 삭제와 같은 가상 스위치 계층 이벤트에 대한 콜백 진입점을 등록합니다.

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

구문

NTSTATUS FwpsvSwitchEventsSubscribe0(
  const GUID                              *providerGuid,
  void                                    *notifyContext,
  UINT32                                  flags,
  void                                    *reserved,
  const FWPS_VSWITCH_EVENT_DISPATCH_TABLE *eventDispatchTable,
  UINT32                                  *subscriptionId
);

매개 변수

providerGuid

공급자 GUID입니다.

notifyContext

설명선 드라이버 제공 컨텍스트에 대한 선택적 포인터입니다. 이벤트 알림 함수는 이 매개 변수를 드라이버에 다시 전달합니다.

flags

예약되어 있습니다. 0으로 설정됩니다.

reserved

예약되어 있습니다. 0으로 설정됩니다.

eventDispatchTable

가상 스위치 계층 이벤트에 대한 콜백 진입점을 정의하는 FWPS_VSWITCH_EVENT_DISPATCH_TABLE 구조체에 대한 포인터입니다.

subscriptionId

WFP가 구독에 할당하는 고유 식별자를 포함하는 변수에 대한 포인터입니다. 호출자는 FwpsvSwitchEventsUnsubscribe0 함수를 사용하여 구독 식별자를 WFP에 반환해야 합니다.

반환 값

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

반환 코드 설명
STATUS_SUCCESS
 분류 요청에 대한 핸들이 성공적으로 반환되었습니다. classifyHandle 매개 변수가 분류 요청에 대한 핸들을 포함하도록 가리키는 변수입니다.
기타 상태 코드
 오류가 발생했습니다.

설명

설명선 드라이버는 FwpsvSwitchEventsSubscribe0 함수를 호출하여 가상 스위치 계층 이벤트에 대한 콜백 진입점을 등록합니다.

콜백 알림 함수의 진입점은 구조에서 지정되고 FWPS_VSWITCH_EVENT_DISPATCH_TABLE0 .

설명선 드라이버는 나중에 FwpsvSwitchEventsUnsubscribe0 을 호출하여 시스템 리소스를 해제해야 합니다.

요구 사항

   
지원되는 최소 클라이언트 Windows 8 시작해서 사용할 수 있습니다.
대상 플랫폼 유니버설
헤더 fwpsk.h(Fwpsk.h 포함)
라이브러리 Fwpkclnt.lib
IRQL <= PASSIVE_LEVEL

참고 항목

FWPS_VSWITCH_EVENT_DISPATCH_TABLE0

FwpsvSwitchEventsUnsubscribe0