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 Revision 멤버 및 NDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1 Size 멤버를 설정합니다.
PortNumber
이벤트 알림의 원본 포트입니다. 상태 표시가 포트와 관련이 없는 경우 PortNumber 0입니다.
NetPnPEvent
이벤트를 설명하는 NET_PNP_EVENT 구조체입니다.
Flags
이 이벤트 알림에 대한 플래그입니다.
중요하다
NdisMNetPnPEvent호출하는 미니포트 드라이버의 경우 VPortId NDIS_DEFAULT_VPORT_ID 다른 값으로 설정된 경우 VPortId 적용하려면 Flags 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_VPORTOID 메서드 요청을 통해 만들어졌어야 합니다.
발언
운영 체제에서 어댑터를 나타내는 대상 디바이스 개체에 시스템 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는 NET_PNP_EVENT_NOTIFICATION 구조에 대한 포인터를 필터 드라이버를 과도하게 사용하는 FilterNetPnPEvent 함수 및 프로토콜 드라이버의 ProtocolNetPnPEvent 함수에 전달합니다.
요구 사항
| 요구 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | NDIS 6.0 이상에서 지원됩니다. |
| 헤더 | ndis.h(Ndis.h 포함) |