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 포함) |