NDIS_NIC_SWITCH_INFO_ARRAY 구조체(ntddndis.h)

아티클
02/29/2024

NDIS_NIC_SWITCH_INFO_ARRAY 구조체는 배열을 지정합니다. 배열의 각 요소는 네트워크 어댑터에서 만든 네트워크 어댑터 스위치의 특성을 지정합니다.

구문

typedef struct _NDIS_NIC_SWITCH_INFO_ARRAY {
  NDIS_OBJECT_HEADER Header;
  ULONG              FirstElementOffset;
  ULONG              NumElements;
  ULONG              ElementSize;
} NDIS_NIC_SWITCH_INFO_ARRAY, *PNDIS_NIC_SWITCH_INFO_ARRAY;

멤버

Header

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

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

NDIS_NIC_SWITCH_INFO_ARRAY_REVISION_1

NDIS 6.30의 원래 버전입니다.

Size 멤버를 NDIS_SIZEOF_NIC_SWITCH_INFO_ARRAY_REVISION_1 설정합니다.

FirstElementOffset

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

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

NumElements

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

ElementSize

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

설명

NDIS는 다음과 같은 방법으로 NDIS_NIC_SWITCH_INFO_ARRAY 구조를 반환합니다.

NDIS는 OID_NIC_SWITCH_ENUM_SWITCHES OID 쿼리 요청을 처리할 때 NDIS_OID_REQUESTInformationBuffer 멤버의 NDIS_NIC_SWITCH_INFO_ARRAY 구조에 대한 포인터를 반환합니다.
NDIS가 ProtocolBindAdapterEx 함수를 호출하면 NDIS는 BindParameters 매개 변수의 NDIS_BIND_PARAMETERS 구조에 대한 포인터를 전달합니다. NDIS는 NDIS_BIND_PARAMETERS 구조체의 NicSwitchArray 멤버를 NDIS_NIC_SWITCH_INFO_ARRAY 구조체에 대한 포인터로 설정합니다.
NDIS가 FilterAttach 함수를 호출하면 NDIS는 AttachParameters 매개 변수의 NDIS_FILTER_ATTACH_PARAMETERS 구조에 대한 포인터를 전달합니다. NDIS는 NDIS_FILTER_ATTACH_PARAMETERS 구조체의 NicSwitchArray 멤버를 NDIS_NIC_SWITCH_INFO_ARRAY 구조체에 대한 포인터로 설정합니다.