次の方法で共有


NDIS_NIC_SWITCH_VPORT_INFO 構造体 (ntddndis.h)

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構造体のバージョンを指定するには、ドライバーで HeaderRevision メンバーを次の値に設定する必要があります。

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

注釈

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

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

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

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

要件

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

こちらもご覧ください

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_CREATE_VPORT

OID_NIC_SWITCH_VPORT_PARAMETERS