NDIS_RECEIVE_FILTER_INFO_ARRAY 구조체(ntddndis.h)

아티클
08/07/2023

NDIS_RECEIVE_FILTER_INFO_ARRAY 구조체는 미니포트 드라이버에 현재 구성된 수신 필터 목록을 지정합니다.

NDIS 수신 필터는 다음 NDIS 인터페이스에서 사용됩니다.

NDIS 패킷 병합. 이 인터페이스에서 수신 필터를 사용하는 방법에 대한 자세한 내용은 패킷 병합 수신 필터 관리를 참조하세요.
SR-IOV(단일 루트 I/O 가상화). 이 인터페이스에서 수신 필터를 사용하는 방법에 대한 자세한 내용은 가상 포트에서 수신 필터 설정을 참조하세요.
VMQ(Virtual Machine Queue). 이 인터페이스에서 수신 필터를 사용하는 방법에 대한 자세한 내용은 VMQ 필터 설정 및 지우기를 참조하세요.

구문

typedef struct _NDIS_RECEIVE_FILTER_INFO_ARRAY {
  NDIS_OBJECT_HEADER       Header;
  NDIS_RECEIVE_QUEUE_ID    QueueId;
  ULONG                    FirstElementOffset;
  ULONG                    NumElements;
  ULONG                    ElementSize;
  ULONG                    Flags;
  NDIS_NIC_SWITCH_VPORT_ID VPortId;
} NDIS_RECEIVE_FILTER_INFO_ARRAY, *PNDIS_RECEIVE_FILTER_INFO_ARRAY;

멤버

Header

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

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

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2

NDIS 6.30에 대한 멤버가 추가되었습니다.

Size 멤버를 NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_2 설정합니다.

NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1

NDIS 6.20의 원래 버전입니다.

Size 멤버를 NDIS_SIZEOF_RECEIVE_FILTER_INFO_ARRAY_REVISION_1 설정합니다.

QueueId

수신 큐 식별자입니다. 이 식별자는 네트워크 어댑터가 지원하는 큐 수와 0 사이의 정수입니다. NDIS_DEFAULT_RECEIVE_QUEUE_ID 값은 기본 수신 큐를 지정합니다.

참고NDIS 패킷 병합 또는 SR-IOV 인터페이스를 지원하는 미니포트 드라이버는 QueueId 멤버를 NDIS_DEFAULT_RECEIVE_QUEUE_ID 설정해야 합니다.

FirstElementOffset

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

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

NumElements

배열의 요소 수입니다.

ElementSize

배열에서 각 요소의 크기(바이트)입니다.

Flags

다음 플래그의 비트 OR입니다.

NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED

이 플래그를 설정하면 VPortId 멤버가 지정한 VPort(가상 포트)에 구성된 수신 필터에 대한 정보가 요청됩니다.

참고 이 플래그는 SR-IOV 인터페이스에만 유효합니다.

VPortId

수신 필터가 쿼리되는 VPort(가상 포트) 식별자입니다. VPort 식별자는 다음 값 중 하나여야 합니다.

OID_NIC_SWITCH_CREATE_VPORT OID 메서드 요청을 통해 이전에 할당된 VPort 의 식별자입니다.
NIC 스위치의 기본 VPort를 지정하는 NDIS_DEFAULT_VPORT_ID 값입니다.

NIC 스위치는 SR-IOV 인터페이스에 대한 네트워크 어댑터에서 지원됩니다. 하나 이상의 VPort를 갖도록 NIC 스위치를 구성할 수 있습니다.

참고VPortId 멤버는 NDIS_RECEIVE_FILTER_INFO_ARRAY_VPORT_ID_SPECIFIED 플래그가 Flags에 설정된 경우에만 유효 합니다.

설명

NDIS_RECEIVE_FILTER_INFO_ARRAY 구조체는 OID_RECEIVE_FILTER_ENUM_FILTERS OID 요청에 사용됩니다. 이 OID 요청은 VMQ 또는 SR-IOV 수신 큐의 수신 필터를 열거합니다. NDIS_RECEIVE_FILTER_INFO_ARRAY 구조체를 따르는 배열의 각 요소는 입니다. NDIS_RECEIVE_FILTER_INFO 구조체입니다.