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 이상에 대한 원래 버전입니다.

Size 멤버를 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 시작해서 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_PARAMETERS 구조는 OID_NIC_SWITCH_ALLOCATE_VF 및OID_NIC_SWITCH_VF_PARAMETERS OID 메서드 요청에 사용됩니다.

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

요구 사항

요구 사항 값
지원되는 최소 클라이언트 NDIS 6.30 이상에서 지원됩니다.
머리글 ntddndis.h(Ndis.h 포함)

추가 정보

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ALLOCATE_VF

OID_NIC_SWITCH_VF_PARAMETERS