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、Revision メンバーをNET_PNP_EVENT_NOTIFICATION_REVISION_1、Size メンバーをNDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1に指定する構造体の Type メンバーを設定します。

PortNumber

イベント通知のソース ポート。 状態表示がポートに固有でない場合、 PortNumber は 0 です。

NetPnPEvent

イベント を 記述するNET_PNP_EVENT構造体。

Flags

このイベント通知のフラグ。

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) に常に接続されます。

注釈

オペレーティング システムがアダプターを表すターゲット デバイス オブジェクトにシステム PnP イベントまたは電源管理イベントを発行すると、NDIS はイベントをNET_PNP_EVENT_NOTIFICATION構造体に変換します。

NetPnPEvent メンバーは、NET_PNP_EVENT構造体です。 このNET_PNP_EVENT構造体の NetEvent メンバーは、ネットワーク PnP イベント、NDIS PnP イベント、または電源管理イベントを識別するイベント コードを指定します。

Buffer メンバーは、NET_PNP_EVENT_NOTIFICATION の NetPnPEvent メンバーで指定されたNET_PNP_EVENT構造体内にあり、NetEvent メンバーによって示されるイベントに固有の情報を含むバッファーのアドレスを指定します。

また、NDIS は、NetEventPause、NetEventRestart、NetEventPortActivation、NetEventPortDeactivation などの NDIS PnP イベントの PnP イベント通知も発行します。

NDIS は、NET_PNP_EVENT_NOTIFICATION構造体へのポインターを、上にあるフィルター ドライバーの FilterNetPnPEvent 関数と、上にあるプロトコル ドライバーの ProtocolNetPnPEvent 関数に渡します。

要件

こちらもご覧ください

FilterNetPnPEvent

NDIS_OBJECT_HEADER

NET_PNP_EVENT

ProtocolNetPnPEvent