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
このイベント通知のフラグ。
重要
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_VPORT の OID メソッド要求を通じて以前に作成されている必要があります。
注釈
オペレーティング システムがアダプターを表すターゲット デバイス オブジェクトにシステム 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 関数に渡します。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | NDIS 6.0 以降でサポートされています。 |
| Header | ndis.h (Ndis.h を含む) |