NDIS_NIC_SWITCH_VPORT_INFO 構造体 (ntddndis.h)

[アーティクル]
08/07/2023

NDIS_NIC_SWITCH_VPORT_INFO構造体は、ネットワークアダプターのネットワークアダプタースイッチ上の仮想ポート (VPort) の構成を指定します。

構文

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO {
  NDIS_OBJECT_HEADER                         Header;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  NDIS_VPORT_NAME                            VPortName;
  NDIS_SRIOV_FUNCTION_ID                     AttachedFunctionId;
  ULONG                                      NumQueuePairs;
  NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION InterruptModeration;
  NDIS_NIC_SWITCH_VPORT_STATE                VPortState;
  GROUP_AFFINITY                             ProcessorAffinity;
  ULONG                                      LookaheadSize;
  ULONG                                      NumFilters;
} NDIS_NIC_SWITCH_VPORT_INFO, *PNDIS_NIC_SWITCH_VPORT_INFO;

メンバー

Header

NDIS_NIC_SWITCH_VPORT_INFO構造体の型、リビジョン、およびサイズ。このメンバーは、 NDIS_OBJECT_HEADER 構造体として書式設定されます。

ミニポートドライバーは、ヘッダーの Type メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_NIC_SWITCH_VPORT_INFO構造体のバージョンを指定するには、ドライバーで Header の Revision メンバーを次の値に設定する必要があります。

NDIS_NIC_SWITCH_VPORT_INFO_REVISION_1

NDIS 6.30 以降の元のバージョン。

[サイズ] メンバーを [NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_REVISION_1] に設定します。

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 メソッド要求を通じて以前に作成されている必要があります。

Flags

フラグのビットごとの OR を含む ULONG 値。このメンバーは NDIS 用に予約されています。

SwitchId

ネットワークアダプターで作成されたネットワークアダプタースイッチを一意に識別するNDIS_NIC_SWITCH_ID値。 VPortId メンバーを介して識別される VPort は、SwitchId メンバーによって指定されたスイッチに作成されます。

スイッチ識別子は、0 からネットワークアダプターがサポートするスイッチの数までの整数です。 NDIS_DEFAULT_SWITCH_ID の値は、既定のネットワークアダプタースイッチを示します。

メモWindows Server 2012以降、単一ルート I/O 仮想化 (SR-IOV) インターフェイスでは、ネットワークアダプターの既定のネットワークアダプタースイッチのみがサポートされます。このメンバーの値は、NDIS_DEFAULT_SWITCH_IDに設定する必要があります。

VPortName

ネットワークアダプタースイッチで作成された VPort の名前を指定するNDIS_VPORT_NAME値。このメンバーには、VPort のわかりやすい説明が含まれています。

AttachedFunctionId

VF または VPort がアタッチされている PF の識別子を指定するNDIS_SRIOV_FUNCTION_ID値。

メモこの値がNDIS_PF_FUNCTION_ID場合、VPort は PF にアタッチされます。

NumQueuePairs

この VPort 用に構成されたキューペアの数を指定する ULONG 値。

キューペアは、送信キューと受信キューで構成されます。既定の VPort に関連付けられているキューペアは、OID_NIC_SWITCH_CREATE_SWITCH の OID メソッド要求を使用してスイッチの作成時に構成されます。 1 つ以上のキューペアは、既定以外の VPort で、OID_NIC_SWITCH_CREATE_VPORTの OID メソッド要求を介して構成されます。

InterruptModeration

VPort の割り込みモデレート設定を指定するNDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION値。

VPortState

VPort の状態を指定するNDIS_NIC_SWITCH_VPORT_STATE値。

ProcessorAffinity

この VPort を関連付けることができる CPU のグループ番号とビットマップを指定するGROUP_AFFINITY値。

このメンバーは、PF にアタッチされている VPort に対してのみ有効です。このフィールドは、VF にアタッチされている既定以外の VPort では無効です。

LookaheadSize

このメンバーは将来使用するために予約されています。このメンバーは 0 に設定する必要があります。

NumFilters

ネットワークアダプターで構成されている受信フィルターの数を指定する ULONG 値。

メモ NDIS 6.30 以降では、ミニポートドライバーは、ネットワークアダプターに設定されている受信フィルターの現在の数のカウンターを維持する必要があります。ドライバーは、OID_RECEIVE_FILTER_SET_FILTERの OID セット要求を通じて受信フィルターが設定されるたびにカウンターをインクリメントする必要があります。ドライバーは、OID_RECEIVE_FILTER_CLEAR_FILTERの OID セット要求を通じて受信フィルターがクリアされるたびにカウンターをデクリメントする必要もあります。