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의 원래 버전입니다.

Size 멤버를 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 시작해서 SR-IOV(단일 루트 I/O 가상화) 인터페이스는 네트워크 어댑터의 기본 네트워크 어댑터 스위치만 지원합니다. 이 멤버의 값은 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) RID(요청자 ID)를 지정하는 NDIS_VF_RID.

설명

NDIS_NIC_SWITCH_VF_INFO 구조체에는 이전에 OID_NIC_SWITCH_ALLOCATE_VF OID 메서드 요청을 통해 만든 VF에 대한 정보가 포함됩니다. 이 OID 요청이 실행되면 하나 이상의 NDIS_NIC_SWITCH_VF_INFO 구조체가 NDIS_NIC_SWITCH_VF_INFO_ARRAY 구조 내에 반환됩니다.

SR-IOV 인터페이스에 대한 자세한 내용은 SR-IOV(단일 루트 I/O 가상화) 개요를 참조하세요.