NET_PNP_EVENT_NOTIFICATION 구조체(ndis.h)

  • 아티클

NET_PNP_EVENT_NOTIFICATION 구조는 네트워크 플러그 앤 플레이(PnP) 이벤트, NDIS PnP 이벤트 또는 전원 관리 이벤트를 설명합니다.

구문

typedef struct _NET_PNP_EVENT_NOTIFICATION {
  NDIS_OBJECT_HEADER       Header;
  NDIS_PORT_NUMBER         PortNumber;
  NET_PNP_EVENT            NetPnPEvent;
  ULONG                    Flags;
  NDIS_NIC_SWITCH_ID       SwitchId;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NET_PNP_EVENT_NOTIFICATION, *PNET_PNP_EVENT_NOTIFICATION;

멤버

Header

NET_PNP_EVENT_NOTIFICATION 구조체의 NDIS_OBJECT_HEADER 구조체입니다. NDIS는 Header가 NDIS_OBJECT_TYPE_DEFAULT 지정하는 구조체의 Type 멤버, NET_PNP_EVENT_NOTIFICATION_REVISION_1 수정 멤버 및 NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1 Size 멤버를 설정합니다.

PortNumber

이벤트 알림의 원본 포트입니다. 상태 표시가 포트와 관련이 없는 경우 PortNumber는 0입니다.

NetPnPEvent

이벤트를 설명하는 NET_PNP_EVENT 구조체입니다.

Flags

이 이벤트 알림에 대한 플래그입니다.

중요

NdisMNetPnPEvent를 호출하는 미니포트 드라이버의 경우 VPortId가 NDIS_DEFAULT_VPORT_ID 다른 값으로 설정된 경우 VPortId가 적용되려면 플래그를 NET_EVENT_FLAGS_VPORT_ID_VALID 설정해야 합니다.

Flags의 다른 값은 NDIS용으로 예약되어 있습니다.

SwitchId

스위치 식별자를 지정하는 NDIS_NIC_SWITCH_ID 값입니다. 스위치 식별자는 네트워크 어댑터가 지원하는 스위치 수와 0 사이의 정수입니다. NDIS_DEFAULT_SWITCH_ID 값은 기본 네트워크 어댑터 스위치를 나타냅니다.

VPortId

네트워크 어댑터에서 VPort(가상 포트)를 고유하게 식별하는 NDIS_NIC_SWITCH_VPORT_ID 값입니다.

NDIS_DEFAULT_VPORT_ID 값은 스위치의 기본 VPort를 지정합니다. 기본 VPort는 항상 네트워크 어댑터의 PCI Express(PCIe) PF(물리적 함수)에 연결됩니다.

참고

지정된 VPortId 값이 있는 기본이 아닌 VPort는 이전에 OID_NIC_SWITCH_CREATE_VPORT OID 메서드 요청을 통해 만들어졌어야 합니다.

설명

운영 체제가 어댑터를 나타내는 대상 디바이스 개체에 시스템 PnP 이벤트 또는 전원 관리 이벤트를 발급하면 NDIS는 이벤트를 NET_PNP_EVENT_NOTIFICATION 구조로 변환합니다.

NetPnPEvent 멤버는 NET_PNP_EVENT 구조체입니다. 이 NET_PNP_EVENT 구조체의 NetEvent 멤버는 네트워크 PnP 이벤트, NDIS PnP 이벤트 또는 전원 관리 이벤트를 식별하는 이벤트 코드를 지정합니다.

NET_PNP_EVENT_NOTIFICATION NetPnPEvent 멤버에 지정된 NET_PNP_EVENT 구조체에 있는 Buffer 멤버는 NetEvent 멤버가 나타내는 이벤트와 관련된 정보를 포함하는 버퍼의 주소를 지정합니다.

또한 NDIS는 NetEventPause, NetEventRestart, NetEventPortActivation 및 NetEventPortDeactivation과 같은 NDIS PnP 이벤트에 대한 PnP 이벤트 알림을 발급합니다.

NDIS는 필터 드라이버를 오버리싱하는 FilterNetPnPEvent 함수 및 프로토콜 드라이버를 과도하게 사용하는 ProtocolNetPnPEvent 함수에 NET_PNP_EVENT_NOTIFICATION 구조에 대한 포인터를 전달합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 NDIS 6.0 이상에서 지원됩니다.
머리글 ndis.h(Ndis.h 포함)

추가 정보

FilterNetPnPEvent

NDIS_OBJECT_HEADER

NET_PNP_EVENT

ProtocolNetPnPEvent