NDIS_NIC_SWITCH_PARAMETERS 구조체(ntddndis.h)

아티클
02/29/2024

NDIS_NIC_SWITCH_PARAMETERS 구조는 네트워크 어댑터의 네트워크 어댑터 스위치 구성 매개 변수를 지정합니다.

구문

typedef struct _NDIS_NIC_SWITCH_PARAMETERS {
  NDIS_OBJECT_HEADER           Header;
  ULONG                        Flags;
  NDIS_NIC_SWITCH_TYPE         SwitchType;
  NDIS_NIC_SWITCH_ID           SwitchId;
  NDIS_NIC_SWITCH_FRIENDLYNAME SwitchFriendlyName;
  ULONG                        NumVFs;
  ULONG                        NdisReserved1;
  ULONG                        NdisReserved2;
  ULONG                        NdisReserved3;
  ULONG                        NumQueuePairsForDefaultVPort;
} NDIS_NIC_SWITCH_PARAMETERS, *PNDIS_NIC_SWITCH_PARAMETERS;

멤버

Header

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

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

NDIS_NIC_SWITCH_PARAMETERS_REVISION_1

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

Size 멤버를 NDIS_SIZEOF_NIC_SWITCH_PARAMETERS_REVISION_1 설정합니다.

Flags

플래그의 비트 OR을 포함하는 ULONG 값입니다. 이 멤버에 대해 다음 플래그가 정의됩니다.

NDIS_NIC_SWITCH_PARAMETERS_SWITCH_NAME_CHANGED

이 플래그는 NDIS_NIC_SWITCH_PARAMETERS 구조에서 업데이트된 필드가 SwitchName 멤버임을 지정합니다.

참고 이 플래그는 이 구조체가 OID_NIC_SWITCH_PARAMETERS OID 집합 요청에 사용되는 경우에만 유효합니다.

SwitchType

네트워크 어댑터 스위치의 형식을 지정하는 NDIS_NIC_SWITCH_TYPE 열거형 값입니다.

참고 Windows Server 2012 Windows는 NdisNicSwitchTypeExternal의 스위치 유형만 지원합니다. 외부 스위치는 이러한 유형의 스위치에 연결된 포트가 네트워크 어댑터의 물리적 포트를 통해 외부 네트워크에 액세스할 수 있도록 지정합니다. 외부 스위치의 기본 VPort(가상 포트)는 Hyper-V 부모 파티션의 관리 운영 체제에서 실행되는 가상화 스택에 대한 외부 네트워크 연결을 제공합니다.

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는 NdisMEnableVirtualization 호출을 통해 가상화가 사용하도록 설정된 경우 어댑터에서 사용하도록 설정됩니다.

참고 VF를 Hyper-V 자식 파티션에 연결하려면 먼저 OID_NIC_SWITCH_ALLOCATE_VF OID 메서드 요청을 통해 리소스를 할당해야 합니다.

NdisReserved1

NDIS용으로 예약되었습니다.

NdisReserved2

NDIS용으로 예약되었습니다.

NdisReserved3

NDIS용으로 예약되었습니다.

NumQueuePairsForDefaultVPort

설명

NDIS_NIC_SWITCH_PARAMETERS 구조는 OID_NIC_SWITCH_CREATE_SWITCH 및 OID_NIC_SWITCH_PARAMETERS OID 메서드 요청에 사용됩니다. 이러한 OID 요청은 네트워크 어댑터 스위치의 구성 매개 변수를 설정하거나 쿼리합니다.

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