NDIS_NIC_SWITCH_VF_PARAMETERS 構造体 (ntddndis.h)

NDIS_NIC_SWITCH_VF_PARAMETERSは、ネットワーク アダプター上の PCI Express (PCIe) 仮想関数 (VF) のリソース パラメーターを指定します。

構文

typedef struct _NDIS_NIC_SWITCH_VF_PARAMETERS {
  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_PARAMETERS, *PNDIS_NIC_SWITCH_VF_PARAMETERS;

メンバー

Header

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

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

NDIS_NIC_SWITCH_VF_PARAMETERS_REVISION_1

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

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

Flags

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

SwitchId

スイッチ識別子を指定するNDIS_NIC_SWITCH_ID値。 この値は、VF が割り当てられているネットワーク アダプター スイッチを識別します。

スイッチ識別子は、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_PARAMETERS構造体は、OID_NIC_SWITCH_ALLOCATE_VFとOID_NIC_SWITCH_VF_PARAMETERSの OID メソッド要求で使用されます。

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

要件

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

こちらもご覧ください

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_VF_PARAMETERS