NDIS_SWITCH_NIC_ARRAY 구조체(ntddndis.h)

아티클
03/05/2024

NDIS_SWITCH_NIC_ARRAY 구조는 네트워크 어댑터 구성 매개 변수의 배열을 지정합니다. 배열의 각 요소는 Hyper-V 확장 가능 스위치의 포트에 연결된 네트워크 어댑터에 대한 매개 변수를 지정합니다. 각 요소의 형식은 NDIS_SWITCH_NIC_PARAMETERS 구조체로 지정됩니다.

구문

typedef struct _NDIS_SWITCH_NIC_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  USHORT             FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_SWITCH_NIC_ARRAY, *PNDIS_SWITCH_NIC_ARRAY;

멤버

Header

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

헤더의 Type 멤버를 NDIS_OBJECT_TYPE_DEFAULT 설정해야 합니다. NDIS_SWITCH_NIC_ARRAY 구조체의 버전을 지정하려면 Header의 Revision 멤버를 다음 값으로 설정해야 합니다.

NDIS_SWITCH_NIC_ARRAY_REVISION_1

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

Size 멤버를 NDIS_SIZEOF_NDIS_SWITCH_NIC_ARRAY_REVISION_1 설정합니다.

Flags

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

FirstElementOffset

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

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

NumElements

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

ElementSize

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

설명

NDIS_SWITCH_NIC_ARRAY 구조체는 OID_SWITCH_NIC_ARRAY OID 쿼리 요청에 반환됩니다. NDIS_SWITCH_NIC_PARAMETERS 구조체의 배열은 OID 쿼리 요청과 연결된 정보 버퍼의 NDIS_SWITCH_NIC_ARRAY 구조를 따릅니다. NDIS_OID_REQUEST 구조체의 InformationBuffer 멤버에는 이 정보 버퍼에 대한 포인터가 포함되어 있습니다.

확장 가능한 스위치 확장은 NDIS_SWITCH_NIC_AT_ARRAY_INDEX 매크로를 사용하여 NDIS_SWITCH_NIC_ARRAY 구조 내의 개별 NDIS_SWITCH_NIC_PARAMETERS 구조에 액세스할 수 있습니다.