次の方法で共有

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 は、NDIS_OBJECT_TYPE_DEFAULT、リビジョン メンバーをNET_PNP_EVENT_NOTIFICATION_REVISION_1、ヘッダー が指定する構造体の の種類 メンバー、およびNDIS_SIZEOF_NET_PNP_EVENT_NOTIFICATION_REVISION_1に サイズ メンバーを設定します。

PortNumber

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

NetPnPEvent

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

Flags

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

大事な

NdisMNetPnPEvent呼び出すミニポート ドライバーの場合、VPortId が NDIS_DEFAULT_VPORT_ID とは異なる値に設定されている場合、VPortId を有効にするには、フラグ をNET_EVENT_FLAGS_VPORT_ID_VALIDに設定する必要があります。

フラグ のその他の値は、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 以降でサポートされています。
ヘッダー ndis.h (Ndis.h を含む)

関連項目

FilterNetPnPEvent の

NDIS_OBJECT_HEADER

NET_PNP_EVENT

ProtocolNetPnPEvent