NDIS_NIC_SWITCH_VF_INFO 構造体 (ntddndis.h)

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

NDIS_NIC_SWITCH_VF_INFO構造体は、ネットワークアダプターに割り当てられている PCI Express (PCIe) 仮想関数 (VF) に関する情報を指定します。

構文

typedef struct _NDIS_NIC_SWITCH_VF_INFO {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_VM_NAME           VMName;
  NDIS_VM_FRIENDLYNAME   VMFriendlyName;
  NDIS_SWITCH_NIC_NAME   NicName;
  USHORT                 MacAddressLength;
  UCHAR                  PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                  CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  NDIS_SRIOV_FUNCTION_ID VFId;
  NDIS_VF_RID            RequestorId;
} NDIS_NIC_SWITCH_VF_INFO, *PNDIS_NIC_SWITCH_VF_INFO;

メンバー

Header

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

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

NDIS_NIC_SWITCH_VF_INFO_REVISION_1

NDIS 6.30 の元のバージョン。

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

Flags

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

SwitchId

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

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

VMName

VF に接続されている Hyper-V 子パーティションの名前を指定するNDIS_VM_NAME値。このメンバーには、パーティションのわかりやすい説明が含まれています。

メモ Hyper-V 子パーティションは、仮想マシン (VM) とも呼ばれます。

VMFriendlyName

VF に接続されている Hyper-V 子パーティションの外部名を指定するNDIS_VM_FRIENDLYNAME値。このメンバーには、パーティションのわかりやすい説明が含まれています。

NicName

仮想マシン (VM) ネットワークアダプターの名前を指定するNDIS_SWITCH_NIC_NAME値。このメンバーには、ネットワークアダプターのわかりやすい説明が含まれています。

VM ネットワークアダプターは、Hyper-V 子パーティションで実行されるゲストオペレーティングシステムで公開される仮想デバイスです。 VM ネットワークアダプターは VF ネットワークアダプターと連携して、SR-IOV インターフェイス経由でハードウェアベースの VF データパスを提供します。

VF データパスの詳細については、「 SR-IOV VF データパス」を参照してください。

MacAddressLength

PermanentMacAddress メンバーと CurrentMacAddress メンバーの長さを指定する USHORT 値。

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

VF の永続的な MAC アドレス。これは、ゲストオペレーティングシステムで公開されている VF ネットワークアダプターの永続的な MAC アドレスです。

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

VF の現在の MAC アドレス。これは、ゲストオペレーティングシステムで公開されている VF ネットワークアダプターの現在の MAC アドレスです。

VFId

ネットワークアダプター上の VF の一意識別子を指定するNDIS_SRIOV_FUNCTION_ID値。

RequestorId

VF の PCI Express (PCIe) リクエスタ ID (RID) を指定するNDIS_VF_RID。

注釈

NDIS_NIC_SWITCH_VF_INFO構造体には、OID_NIC_SWITCH_ALLOCATE_VF の OID メソッド要求によって以前に作成された VF に関する情報が含まれています。この OID 要求が発行されると、 NDIS_NIC_SWITCH_VF_INFO_ARRAY 構造体内で 1 つ以上の NDIS_NIC_SWITCH_VF_INFO 構造体が返されます。

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