FILTER_NET_PNP_EVENT 콜백 함수(ndis.h)

아티클
08/07/2023

NDIS는 필터 드라이버의 FilterNetPnPEvent 함수를 호출하여 드라이버에 PnP(네트워크 플러그 앤 플레이) 및 전원 관리 이벤트를 알립니다.

참고FILTER_NET_PNP_EVENT 형식을 사용하여 함수를 선언해야 합니다. 자세한 내용은 다음 예제 섹션을 참조하세요.

구문

FILTER_NET_PNP_EVENT FilterNetPnpEvent;

NDIS_STATUS FilterNetPnpEvent(
  [in] NDIS_HANDLE FilterModuleContext,
  [in] PNET_PNP_EVENT_NOTIFICATION NetPnPEventNotification
)
{...}

매개 변수

[in] FilterModuleContext

필터 모듈의 컨텍스트 영역에 대한 핸들입니다. FilterAttach 함수에서 이 컨텍스트 영역을 만들고 초기화한 필터 드라이버입니다.

[in] NetPnPEventNotification

에 대한 포인터입니다. 필터 드라이버에 표시되는 PnP 이벤트 또는 전원 관리 이벤트를 설명하는 NET_PNP_EVENT_NOTIFICATION 구조체입니다.

반환 값

FilterNetPnPEvent 는 다음 중 하나를 반환할 수 있습니다.

반환 코드	설명
NDIS_STATUS_SUCCESS	드라이버가 PnP 이벤트를 성공적으로 처리했습니다.
NDIS_STATUS_FAILURE	드라이버가 PnP 이벤트에 실패했습니다.

반환 값은 전파된 이벤트가 NetEventQueryPower 또는 NetEventQueryRemove 이벤트인 경우에만 중요합니다. 전파된 다른 모든 이벤트의 경우 반환 값은 항상 NDIS_STATUS_SUCCESS.

설명

FilterNetPnPEvent 는 선택적 함수입니다. 필터 드라이버가 네트워크 PnP 이벤트를 처리하지 않는 경우 를 호출할 때 이 함수의 진입점을 NULL 로 설정할 수 있습니다. NdisFRegisterFilterDriver 함수입니다.

FilterNetPnPEvent 는 프로토콜 드라이버의 ProtocolNetPnPEvent 함수와 유사합니다. 필터 드라이버는 이러한 알림을 지나치게 많은 드라이버에 전달하거나 전달하지 않고 자체적으로 처리할 수 있습니다. 알림을 전달하려면 NdisFNetPnPEvent 함수를 호출합니다. 이 함수를 와 혼동하지 마세요. FilterDevicePnPEventNotify 함수는 스택 아래로 전달되는 알림을 기본 드라이버로 필터링합니다.

NDIS는 FilterNetPnPEvent 를 호출하여 기본 NIC에 대해 발급된 PnP 또는 전원 관리 이벤트의 필터 드라이버에 알립니다. NDIS는 NIC를 오버리딩하는 각 필터 드라이버의 FilterNetPnPEvent 함수를 호출한 다음, 각 오버리싱 프로토콜 드라이버의 ProtocolNetPnPEvent 함수를 호출합니다.

드라이버 스택에 필터 모듈을 삽입하거나 삭제하면 스택의 특성이 변경될 수 있습니다. NDIS는 영향을 받는 모든 프로토콜 바인딩 및 필터 모듈에 PnP 이벤트를 전송하여 이 변경에 대해 알립니다. 필터 드라이버는 이러한 변경 내용을 적절하게 처리해야 합니다.

NDIS는 IRQL = PASSIVE_LEVEL FilterNetPnPEvent 를 호출합니다.

예

FilterNetPnPEvent 함수를 정의하려면 먼저 정의 중인 함수의 형식을 식별하는 함수 선언을 제공해야 합니다. Windows는 드라이버에 대한 함수 형식 집합을 제공합니다. 함수 형식을 사용하여 함수를 선언하면 드라이버에 대한 코드 분석, SDV( 정적 드라이버 검증 도구 ) 및 기타 확인 도구에서 오류를 찾을 수 있으며 Windows 운영 체제용 드라이버를 작성하기 위한 요구 사항입니다.

예를 들어 이름이 " MyNetPnPEvent"인 FilterNetPnPEvent 함수를 정의하려면 다음 코드 예제와 같이 FILTER_NET_PNP_EVENT 형식을 사용합니다.

FILTER_NET_PNP_EVENT MyNetPnPEvent;

그런 다음 다음과 같이 함수를 구현합니다.

_Use_decl_annotations_
NDIS_STATUS
 MyNetPnPEvent(
    NDIS_HANDLE  FilterModuleContext,
    PNET_PNP_EVENT_NOTIFICATION  NetPnPEvent
    )
  {...}

FILTER_NET_PNP_EVENT 함수 형식은 Ndis.h 헤더 파일에 정의되어 있습니다. 코드 분석 도구를 실행할 때 오류를 보다 정확하게 식별하려면 함수 정의에 Use_decl_annotations 주석을 추가해야 합니다. Use_decl_annotations 주석은 헤더 파일의 FILTER_NET_PNP_EVENT 함수 형식에 적용되는 주석이 사용되도록 합니다. 함수 선언 요구 사항에 대한 자세한 내용은 NDIS 드라이버에 함수 역할 형식을 사용하여 함수 선언을 참조하세요.

Use_decl_annotations 대한 자세한 내용은 함수 동작 주석 지정을 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	NDIS 6.0 이상에서 지원됩니다.
대상 플랫폼	Windows
헤더	ndis.h(Ndis.h 포함)
IRQL	PASSIVE_LEVEL