NDIS_RECEIVE_SCALE_PARAMETERS_V2 구조체(ntddndis.h)

아티클
08/07/2023

경고

이 항목의 일부 정보는 상업적으로 출시되기 전에 실질적으로 수정될 수 있는 미리 출시된 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.

RSSv2는 Windows 10 버전 1803에서만 미리 보기로 제공됩니다.

NDIS_RECEIVE_SCALE_PARAMETERS_V2 구조는 RSS 버전 2(RSSv2)에 대한 지원을 보급하는 미니포트 어댑터에 대한 RSS(수신 측 크기 조정) 매개 변수를 지정합니다. OID_GEN_RECEIVE_SCALE_PARAMETERS_V2 OID에서 사용됩니다.

구문

typedef struct _NDIS_RECEIVE_SCALE_PARAMETERS_V2 {
  NDIS_OBJECT_HEADER Header;
  ULONG              Flags;
  ULONG              HashInformation;
  ULONG              HashSecretKeySize;
  ULONG              HashSecretKeyOffset;
  ULONG              NumberOfQueues;
  ULONG              NumberOfIndirectionTableEntries;
} NDIS_RECEIVE_SCALE_PARAMETERS_V2, *PNDIS_RECEIVE_SCALE_PARAMETERS_V2;

멤버

Header

NDIS_RECEIVE_SCALE_PARAMETERS_V2 구조체에 대한 NDIS_OBJECT_HEADER 구조체입니다. Header에서 지정하는 구조체의 Type 멤버를 NDIS_OBJECT_TYPE_RSS_PARAMETERS_V2 설정합니다.

NDIS 6.80 이상 드라이버의 경우 Revision 멤버를 NDIS_RECEIVE_SCALE_PARAMETERS_V2_REVISION_1 , Size 멤버를 sizeof(NDIS_RECEIVE_SCALE_PARAMETERS_V2)로 설정합니다.

Flags

변경되는 매개 변수를 나타내는 ULONG 값입니다. 드라이버는 이러한 플래그를 사용하여 변경된 매개 변수를 신속하게 확인하고 그에 따라 RSS 설정을 업데이트할 수 있습니다.

쿼리 요청에서 이 멤버를 0으로 설정합니다.

집합 요청에서 플래그는 다음과 같이 정의됩니다.

값	의미
NDIS_RECEIVE_SCALE_PARAM_ENABLE_RSS	값 이 1 이면 지정된 개체에 RSS가 사용하도록 설정되어 있음을 나타냅니다. 미니포트 드라이버는 다른 매개 변수를 확인해야 합니다. 값 이 0 이면 지정된 개체에 대해 RSS를 사용할 수 없음을 나타냅니다. RSS를 사용하지 않도록 설정하면 NumberOfQueues 및 NumberOfIndirectionTableEntries 매개 변수가 변경됩니다. RSS를 사용하지 않도록 설정하면 HashInformation 및 HashKey 와 같은 다른 매개 변수를 무시해야 합니다.
NDIS_RECEIVE_SCALE_PARAM_HASH_INFO_CHANGED	HashInformation 매개 변수의 값이 변경되었습니다.
NDIS_RECEIVE_SCALE_PARAM_HASH_KEY_CHANGED	HashSecretKey 멤버의 콘텐츠가 변경되었습니다.
NDIS_RECEIVE_SCALE_PARAM_NUMBER_OF_QUEUES_CHANGED	VPort당 큐 수가 변경되었습니다.
NDIS_RECEIVE_SCALE_PARAM_NUMBER_OF_ENTRIES_CHANGED	간접 참조 테이블의 항목 수가 변경되었습니다.

HashInformation

집합 요청에서 이 멤버는 NIC가 들어오는 패킷에 대한 해시 값을 계산하는 데 사용해야 하는 해시 형식 및 해시 함수입니다. HashInformation 멤버 내에 지정된 해시 함수가 0이면 RSS가 비활성화됩니다.

쿼리 요청에서 이 멤버는 NIC에서 사용하는 해시 형식 및 해시 함수입니다.

드라이버와 NDIS를 과도하게 사용하면 NDIS_RSS_HASH_INFO_FROM_TYPE_AND_FUNC 매크로를 사용하여 해시 형식과 해시 함수를 해시 정보로 결합하고 HashInformation 멤버를 설정할 수 있습니다.

미니포트 드라이버는 NDIS_RSS_HASH_TYPE_FROM_HASH_INFO 매크로를 사용하여 HashInformation 및 NDIS_RSS_HASH_FUNC_FROM_HASH_INFO 매크로에서 해시 형식을 가져와 해시 함수를 가져올 수 있습니다.

이 매개 변수는 RSS를 사용하는 동시에 또는 나중에 변경할 수 있습니다.

HashSecretKeySize

해시 함수의 비밀 키 배열 크기(바이트)입니다. 배열의 크기는 NdisHashFunctionToeplitz의 경우 40바이트입니다.

이 매개 변수는 RSS를 사용하는 동시에 또는 나중에 변경할 수 있습니다.

HashSecretKeyOffset

해시 비밀 키의 오프셋(바이트)입니다.

이 매개 변수는 RSS를 사용하는 동시에 또는 나중에 변경할 수 있습니다.

NumberOfQueues

크기 조정 엔터티에 대한 최대 큐 수입니다. 이 매개 변수는 NDIS_NIC_SWITCH_VPORT_PARAMETERS 구조체의 NUM_QUEUE_PAIRS 변수에 대한 별칭이며 OID_NIC_SWITCH_VPORT_PARAMETERS OID를 통해 쿼리하거나 설정할 수도 있습니다. RSS를 사용하거나 사용하지 않도록 설정하면 변경할 수 있습니다.

NumberOfIndirectionTableEntries

크기 조정 엔터티에 대한 간접 처리 테이블 항목(IT)의 수입니다. 이 값은 2의 전원이며 해당 어댑터의 기능을 초과하지 않습니다. RSS를 사용하도록 설정하기 전 또는 나중에 변경할 수 있습니다.

이 매개 변수의 새 값도 2의 강력한 기능이며 어댑터 기능을 초과합니다. 이 수를 늘리면 미니포트 드라이버가 현재 간접 참조 테이블을 필요에 따라 여러 번 새 IT에 복제해야 합니다(두 가지 제한 기능으로 인해 가능). 이 수를 줄이면 상위 계층은 제거되는 간접 참조 테이블의 부분에 나머지 부분의 정확한 복제본이 포함되어 있음을 보장합니다.