NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 구조체(ntddndis.h)

아티클
08/07/2023

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 구조체는 배열을 지정합니다. 배열의 각 요소는 네트워크 어댑터의 네트워크 어댑터 스위치에 생성된 VPort(가상 포트)의 특성을 지정합니다.

구문

typedef struct _NDIS_NIC_SWITCH_VPORT_INFO_ARRAY {
  NDIS_OBJECT_HEADER     Header;
  ULONG                  Flags;
  NDIS_NIC_SWITCH_ID     SwitchId;
  NDIS_SRIOV_FUNCTION_ID AttachedFunctionId;
  ULONG                  FirstElementOffset;
  ULONG                  NumElements;
  ULONG                  ElementSize;
} NDIS_NIC_SWITCH_VPORT_INFO_ARRAY, *PNDIS_NIC_SWITCH_VPORT_INFO_ARRAY;

멤버

Header

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

NDIS는 헤더의 Type 멤버를 NDIS_OBJECT_TYPE_DEFAULT 설정합니다. NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 구조체의 버전을 지정하기 위해 NDIS는 Header의 Revision 멤버를 다음 값으로 설정합니다.

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1

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

Size 멤버를 NDIS_SIZEOF_NIC_SWITCH_VPORT_INFO_ARRAY_REVISION_1 설정합니다.

Flags

다음 플래그의 비트 OR을 포함하는 ULONG 값입니다.

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION

이 플래그는 특정 PCI Express(PCIe) 함수에 연결된 VPort를 열거하도록 지정합니다. 함수는 AttachedFunctionId 멤버에 지정됩니다. 이 플래그를 사용하여 PCIe PF(물리적 함수) 또는 지정된 PCIe VF(가상 함수)에 연결된 VPort를 열거할 수 있습니다.

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

이 플래그는 SwitchId로 지정된 특정 스위치에서 만든 VPort를 열거하도록 지정합니다. 그러면 스위치에서 만든 모든 VPort가 열거됩니다.

참고 이러한 플래그는 상호 배타적입니다. Flags 멤버에는 하나의 플래그 만 설정할 수 있습니다.

SwitchId

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

SwitchId 멤버는 flags 멤버에 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH 지정한 경우에만 유효합니다.

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

AttachedFunctionId

네트워크 어댑터의 PF 또는 VF 식별자를 지정하는 NDIS_SRIOV_FUNCTION_ID 값입니다.

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

AttachedFunctionId 멤버는 flags 멤버에 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY_ENUM_ON_SPECIFIC_FUNCTION 지정된 경우에만 유효합니다.

FirstElementOffset

이 구조체를 따르는 요소 배열의 첫 번째 요소에 대한 오프셋(바이트)을 지정하는 ULONG 값입니다. 오프셋은 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 구조체의 시작부터 첫 번째 요소의 시작까지 측정됩니다. 배열의 각 요소는 NDIS_NIC_SWITCH_VPORT_INFO 구조체입니다.

참고NumElements 가 0으로 설정된 경우 이 멤버는 무시됩니다.

NumElements

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 구조체를 따르는 요소의 수를 지정하는 ULONG 값입니다.

ElementSize

NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 구조체를 따르는 각 요소의 크기(바이트)를 지정하는 ULONG 값입니다.

설명

NDIS는 NDIS가 OID_NIC_SWITCH_ENUM_VPORTS OID 메서드 요청을 처리할 때 NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 구조를 반환합니다. NDIS_NIC_SWITCH_VPORT_INFO_ARRAY 구조 뒤에 있는 배열의 각 요소는 입니다.
NDIS_NIC_SWITCH_VPORT_INFO 구조체입니다.

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

요구 사항

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

추가 정보

NDIS_NIC_SWITCH_VPORT_INFO

NDIS_OBJECT_HEADER

OID_NIC_SWITCH_ENUM_VPORTS