NDIS_NIC_SWITCH_VF_INFO_ARRAY 구조체(ntddndis.h)

아티클
08/07/2023

NDIS_NIC_SWITCH_VF_INFO_ARRAY 구조체는 배열을 지정합니다. 배열의 각 요소는 네트워크 어댑터에서 사용하도록 설정되고 할당된 PCI Express(PCIe) VF(가상 함수)의 특성을 지정합니다.

구문

typedef struct _NDIS_NIC_SWITCH_VF_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  NDIS_NIC_SWITCH_ID SwitchId;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_VF_INFO_ARRAY, *PNDIS_NIC_SWITCH_VF_INFO_ARRAY;

멤버

Header

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

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

NDIS_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1

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

Size 멤버를 NDIS_SIZEOF_NIC_SWITCH_VF_INFO_ARRAY_REVISION_1 설정합니다.

Flags

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

NDIS_NIC_SWITCH_VF_INFO_ARRAY_ENUM_ON_SPECIFIC_SWITCH

이 플래그가 설정된 경우 미니포트 드라이버는 SwitchId 멤버가 지정한 네트워크 어댑터 스위치에 할당된 VF에 대한 NDIS_NIC_SWITCH_VF_INFO 구조의 배열만 반환해야 합니다. 자세한 내용은 주의 섹션을 참조하세요.

Flags 멤버가 0으로 설정된 경우 미니포트 드라이버는 네트워크 어댑터의 모든 네트워크 어댑터 스위치에 할당된 모든 VF에 대해 NDIS_NIC_SWITCH_VF_INFO 구조의 배열을 반환해야 합니다.

참고 Windows Server 2012 SR-IOV 인터페이스는 네트워크 어댑터의 기본 네트워크 어댑터 스위치만 지원합니다. 따라서 미니포트 드라이버는 기본 네트워크 어댑터 스위치에 할당된 각 VF에 대한 NDIS_NIC_SWITCH_VF_INFO 구조의 배열만 반환해야 합니다.

SwitchId

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

참고 Windows Server 2012 SR-IOV 인터페이스는 네트워크 어댑터에서 만든 기본 네트워크 어댑터 스위치만 지원합니다. 따라서 이 멤버는 항상 NDIS_DEFAULT_SWITCH_ID 설정해야 합니다.

FirstElementOffset

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

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

NumElements

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

ElementSize

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

설명

NDIS는 OID_NIC_SWITCH_ENUM_VFS OID 메서드 요청을 처리할 때 NDIS_NIC_SWITCH_VF_INFO_ARRAY 구조를 반환합니다. NDIS_NIC_SWITCH_VF_INFO_ARRAY 구조체를 따르는 배열의 각 요소는 입니다.
NDIS_NIC_SWITCH_VF_INFO 구조체입니다.