NDIS_NIC_SWITCH_VPORT_INFO 구조체(ntddndis.h)

아티클
08/07/2023

NDIS_NIC_SWITCH_VPORT_INFO 구조는 네트워크 어댑터의 네트워크 어댑터 스위치에서 VPort(가상 포트)에 대한 구성을 지정합니다.

구문

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO {
  NDIS_OBJECT_HEADER                         Header;
  NDIS_NIC_SWITCH_VPORT_ID                   VPortId;
  ULONG                                      Flags;
  NDIS_NIC_SWITCH_ID                         SwitchId;
  NDIS_VPORT_NAME                            VPortName;
  NDIS_SRIOV_FUNCTION_ID                     AttachedFunctionId;
  ULONG                                      NumQueuePairs;
  NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION InterruptModeration;
  NDIS_NIC_SWITCH_VPORT_STATE                VPortState;
  GROUP_AFFINITY                             ProcessorAffinity;
  ULONG                                      LookaheadSize;
  ULONG                                      NumFilters;
} NDIS_NIC_SWITCH_VPORT_INFO, *PNDIS_NIC_SWITCH_VPORT_INFO;

멤버

Header

NDIS_NIC_SWITCH_VPORT_INFO 구조체의 형식, 수정 버전 및 크기입니다. 이 멤버는 NDIS_OBJECT_HEADER 구조체로 형식이 지정됩니다.

미니포트 드라이버는 헤더의 Type 멤버를 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다. NDIS_NIC_SWITCH_VPORT_INFO 구조체의 버전을 지정하려면 드라이버가 Header의 Revision 멤버를 다음 값으로 설정해야 합니다.

NDIS_NIC_SWITCH_VPORT_INFO_REVISION_1

NDIS 6.30 이상에 대한 원래 버전입니다.

Size 멤버를 NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_REVISION_1 설정합니다.

VPortId

네트워크 어댑터에서 VPort(가상 포트)를 고유하게 식별하는 NDIS_NIC_SWITCH_VPORT_ID 값입니다.

NDIS_DEFAULT_VPORT_ID 값은 스위치의 기본 VPort를 지정합니다. 기본 VPort는 항상 네트워크 어댑터의 PCI Express(PCIe) PF(물리적 함수)에 연결됩니다.

참고 지정된 VPortId 값이 있는 기본이 아닌 VPort는 이전에 OID_NIC_SWITCH_CREATE_VPORT OID 메서드 요청을 통해 만들어졌어야 합니다.

Flags

플래그의 비트 OR을 포함하는 ULONG 값입니다. 이 멤버는 NDIS용으로 예약되어 있습니다.

SwitchId

네트워크 어댑터에서 만든 네트워크 어댑터 스위치를 고유하게 식별하는 NDIS_NIC_SWITCH_ID 값입니다. VPortId 멤버를 통해 식별된 VPort는 SwitchId 멤버가 지정한 스위치에 만들어집니다.

스위치 식별자는 네트워크 어댑터가 지원하는 스위치 수와 0 사이의 정수입니다. NDIS_DEFAULT_SWITCH_ID 값은 기본 네트워크 어댑터 스위치를 나타냅니다.

참고 Windows Server 2012 시작해서 SR-IOV(단일 루트 I/O 가상화) 인터페이스는 네트워크 어댑터의 기본 네트워크 어댑터 스위치만 지원합니다. 이 멤버의 값은 NDIS_DEFAULT_SWITCH_ID 설정해야 합니다.

VPortName

네트워크 어댑터 스위치에서 만든 VPort의 이름을 지정하는 NDIS_VPORT_NAME 값입니다. 이 멤버에는 VPort에 대한 사용자에게 친숙한 설명이 포함되어 있습니다.

AttachedFunctionId

VPort가 연결된 VF 또는 PF의 식별자를 지정하는 NDIS_SRIOV_FUNCTION_ID 값입니다.

참고 이 값이 NDIS_PF_FUNCTION_ID VPort는 PF에 연결됩니다.

NumQueuePairs

이 VPort에 대해 구성된 큐 쌍의 수를 지정하는 ULONG 값입니다.

큐 쌍은 전송 큐 및 수신 큐로 구성됩니다. 기본 VPort와 연결된 큐 쌍은 스위치를 만들 때 OID_NIC_SWITCH_CREATE_SWITCH OID 메서드 요청을 통해 구성됩니다. 하나 이상의 큐 쌍은 OID_NIC_SWITCH_CREATE_VPORT OID 메서드 요청을 통해 기본이 아닌 VPort에서 구성됩니다.

InterruptModeration

VPort의 인터럽트 조정 설정을 지정하는 NDIS_NIC_SWITCH_VPORT_INTERRUPT_MODERATION 값입니다.

VPortState

VPort의 상태를 지정하는 NDIS_NIC_SWITCH_VPORT_STATE 값입니다.

ProcessorAffinity

이 VPort와 연결할 수 있는 CPU의 그룹 번호 및 비트맵을 지정하는 GROUP_AFFINITY 값입니다.

이 멤버는 PF에 연결된 VPort에만 유효합니다. 이 필드는 VF에 연결된 기본이 아닌 VPort에는 유효하지 않습니다.

LookaheadSize

이 멤버는 나중에 사용하도록 예약되어 있습니다. 이 멤버는 0으로 설정해야 합니다.

NumFilters

네트워크 어댑터에 구성된 수신 필터 수를 지정하는 ULONG 값입니다.

참고 NDIS 6.30부터 미니포트 드라이버는 네트워크 어댑터에 설정된 현재 수신 필터 수에 대한 카운터를 유지해야 합니다. 드라이버는 수신 필터가 OID_RECEIVE_FILTER_SET_FILTER OID 집합 요청을 통해 설정될 때마다 카운터를 증가시켜야 합니다. 또한 드라이버는 OID_RECEIVE_FILTER_CLEAR_FILTER OID 집합 요청을 통해 수신 필터를 지울 때마다 카운터를 감소시켜야 합니다.