NDIS_NIC_SWITCH_VPORT_INFO構造体 (ntddndis.h)

[アーティクル]
02/07/2025

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 構造体として書式設定されます。

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

NDIS_NIC_SWITCH_VPORT_INFO_REVISION_1

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

Size メンバーを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

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

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

NumQueuePairs

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

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

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 セット要求を通じてクリアされるたびにカウンターをデクリメントする必要があります。

備考

NDIS_NIC_SWITCH_VPORT_INFO 構造体には、次のいずれかに関する情報が含まれています。

OID_NIC_SWITCH_CREATE_VPORTの OID メソッド要求によって以前に作成された既定以外の VPort。
PF にアタッチされている既定の VPort。既定の VPort は常に存在し、削除できません。

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 構造体を介して 1 つ以上の NDIS_NIC_SWITCH_VPORT_INFO 構造体が返されます。

SR-IOV インターフェイスの詳細については、「シングルルート I/O 仮想化の概要 (SR-IOV)を参照してください。

必要条件

要件	価値
サポートされる最小クライアント	NDIS 6.30 以降でサポートされています。
ヘッダー	ntddndis.h (Ndis.h を含む)

次の方法で共有

NDIS_NIC_SWITCH_VPORT_INFO構造体 (ntddndis.h)

構文

メンバーズ

NDIS_NIC_SWITCH_VPORT_INFO_REVISION_1

備考

必要条件

関連項目

フィードバック

その他のリソース