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 構造体として書式設定されます。
ミニポート ドライバーは、ヘッダー の 型 メンバーをNDIS_OBJECT_TYPE_DEFAULTに設定する必要があります。 NDIS_NIC_SWITCH_VF_PARAMETERS 構造体のバージョンを指定するには、ドライバーは、ヘッダー の リビジョン メンバーを次の値に設定する必要があります。
NDIS_NIC_SWITCH_VF_PARAMETERS_REVISION_1
NDIS 6.30 以降の元のバージョン。
Size メンバーを NDIS_SIZEOF_NIC_SWITCH_VF_PARAMETERS_REVISION_1 に設定します。
Flags
フラグのビットごとの OR を含む ULONG 値。 このメンバーは NDIS 用に予約されています。
SwitchId
スイッチ識別子を指定するNDIS_NIC_SWITCH_ID値。 この値は、VF が割り当てられているネットワーク アダプター スイッチを識別します。
スイッチ識別子は、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 データ パスの詳細については、「VF データ パス SR-IOV を参照してください。
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 以降でサポートされています。 |
| ヘッダー | ntddndis.h (Ndis.h を含む) |
関連項目