次の方法で共有


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、NetEventPortActivationNetEventPortDeactivation などの NDIS PnP イベントの PnP イベント通知も発行します。

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

要件

要件
サポートされている最小のクライアント NDIS 6.0 以降でサポートされています。
Header ndis.h (Ndis.h を含む)

こちらもご覧ください

FilterNetPnPEvent

NDIS_OBJECT_HEADER

NET_PNP_EVENT

ProtocolNetPnPEvent