NDIS_NIC_SWITCH_VF_INFO 構造体 (ntddndis.h)

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値は、既定のネットワーク アダプター スイッチを示します。

VMName

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

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)」を参照してください。

要件

こちらもご覧ください

NDIS_NIC_SWITCH_VF_INFO_ARRAY

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ALLOCATE_VF