NDIS_NIC_SWITCH_INFO 구조체(ntddndis.h)

아티클
08/07/2023

NDIS_NIC_SWITCH_INFO 구조는 네트워크 어댑터의 네트워크 어댑터 스위치에 대한 정보를 지정합니다.

구문

typedef struct _NDIS_NIC_SWITCH_INFO {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NumAllocatedVFs;
  ULONG                        NumVPorts;
  ULONG                        NumActiveVPorts;
  ULONG                        NumQueuePairsForDefaultVPort;
  ULONG                        NumQueuePairsForNonDefaultVPorts;
  ULONG                        NumActiveDefaultVPortMacAddresses;
  ULONG                        NumActiveNonDefaultVPortMacAddresses;
  ULONG                        NumActiveDefaultVPortVlanIds;
  ULONG                        NumActiveNonDefaultVPortVlanIds;
} NDIS_NIC_SWITCH_INFO, *PNDIS_NIC_SWITCH_INFO;

멤버

Header

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

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

NDIS_NIC_SWITCH_INFO_REVISION_1

NDIS 6.30의 원래 버전입니다.

Size 멤버를 NDIS_SIZEOF_NIC_SWITCH_INFO_REVISION_1 설정합니다.

Flags

스위치에서 사용하도록 설정된 구성 플래그의 비트 OR을 포함하는 ULONG 값입니다.

참고 NDIS 6.30의 경우 스위치에 대한 구성 플래그가 정의되지 않습니다. Flags 멤버는 0으로 설정해야 합니다.

SwitchType

스위치의 형식을 지정하는 NDIS_NIC_SWITCH_TYPE 값입니다.

SwitchId

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

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

SwitchFriendlyName

스위치에 대한 사용자에게 친숙한 설명을 포함하는 NDIS_NIC_SWITCH_FRIENDLYNAME 값입니다.

NumVFs

네트워크 어댑터에서 사용하도록 설정된 PCI Express(PCIe) VF(가상 함수) 수를 지정하는 ULONG 값입니다. 사용하도록 설정된 VF는 할당되거나 할당되지 않은 상태일 수 있습니다.

NumAllocatedVFs

SwitchId로 지정된 네트워크 어댑터 스위치에 할당된 VF 수를 지정하는 ULONG 값입니다. VF는 OID_NIC_SWITCH_ALLOCATE_VF OID 집합 요청을 통해 할당됩니다.

NumVPorts

SwitchId로 지정된 네트워크 어댑터 스위치에 구성된 VPort(가상 포트) 수를 지정하는 ULONG 값입니다.

이 ULONG 값은 다음의 합계입니다.

OID_NIC_SWITCH_CREATE_VPORT OID 집합 요청을 통해 만들 수 있는 최대 VPort 수입니다.
PF(물리적 함수)에 연결된 기본 VPort입니다.

NumActiveVPorts

SwitchId로 지정된 네트워크 어댑터 스위치에 생성된 VPort 수를 지정하는 ULONG 값입니다.

참고 이 ULONG 값에는 기본 VPort와 OID_NIC_SWITCH_CREATE_VPORT OID 집합 요청을 통해 생성된 기본 VPort가 포함됩니다.

NumQueuePairsForDefaultVPort

기본 VPort에 할당된 큐 쌍 수를 지정하는 ULONG 값입니다. 기본 VPort는 항상 PF에 연결됩니다.

큐 쌍은 전송 큐 및 수신 큐로 구성됩니다. 미니포트 드라이버는 스위치를 만들 때 OID_NIC_SWITCH_CREATE_SWITCH OID 메서드 요청을 통해 하나 이상의 큐 쌍을 기본 VPort와 연결합니다.

참고 NDIS 6.30부터 기본 VPort에 대해 구성할 수 있는 큐 쌍은 하나만 있을 수 있습니다.

NumQueuePairsForNonDefaultVPorts

기본이 아닌 VPort에 할당된 큐 쌍 수를 지정하는 ULONG 값입니다. 기본이 아닌 VPort는 PF 또는 네트워크 어댑터의 모든 VF에 연결할 수 있습니다.

미니포트 드라이버는 OID_NIC_SWITCH_CREATE_VPORT OID 메서드 요청을 통해 하나 이상의 큐 쌍을 기본이 아닌 VPort와 연결합니다.

NumActiveDefaultVPortMacAddresses

네트워크 어댑터의 PF에 연결된 기본 VPort에 현재 설정된 유니캐스트 MAC 주소 필터의 수를 지정하는 ULONG 값입니다.

NumActiveNonDefaultVPortMacAddresses

현재 기본이 아닌 VPort에 설정된 유니캐스트 MAC 주소 필터의 수를 지정하는 ULONG 값입니다.

NumActiveDefaultVPortVlanIds

현재 기본 VPort에 설정된 VLAN(가상 로컬 영역 네트워크) 식별자 필터 수를 지정하는 ULONG 값입니다.

NumActiveNonDefaultVPortVlanIds

현재 기본이 아닌 VPort에 설정된 VLAN 식별자 필터 수를 지정하는 ULONG 값입니다.

설명

NDIS_NIC_SWITCH_INFO 구조는 OID_NIC_SWITCH_ENUM_SWITCHES OID 쿼리 요청에 사용됩니다. 이 OID 요청은 네트워크 어댑터의 네트워크 어댑터 스위치를 열거하는 데 사용됩니다. 이 OID 요청이 실행되면 하나 이상의 NDIS_NIC_SWITCH_INFO 구조체가 NDIS_NIC_SWITCH_INFO_ARRAY 구조 내에 반환됩니다.

참고 NDIS 6.30부터 기본 네트워크 어댑터 스위치에 대한 정보를 설명하는 NDIS_NIC_SWITCH_INFOOID_NIC_SWITCH_ENUM_SWITCHES OID 요청을 통해 반환됩니다.

NDIS_NIC_SWITCH_INFO 구조에는 OID_NIC_SWITCH_CREATE_SWITCH OID 메서드 요청을 통해 이전에 만든 네트워크 어댑터 스위치에 대한 정보가 포함됩니다.

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