NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 구조체(ndis.h)

아티클
02/06/2022
읽는 데 7분 걸림

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 구조체는 네트워크 어댑터의 하드웨어 지원 특성을 지정합니다.

구문

typedef struct _NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES {
  NDIS_OBJECT_HEADER                Header;
  PNDIS_HD_SPLIT_ATTRIBUTES         HDSplitAttributes;
  PNDIS_RECEIVE_FILTER_CAPABILITIES HardwareReceiveFilterCapabilities;
  PNDIS_RECEIVE_FILTER_CAPABILITIES CurrentReceiveFilterCapabilities;
  PNDIS_NIC_SWITCH_CAPABILITIES     HardwareNicSwitchCapabilities;
  PNDIS_NIC_SWITCH_CAPABILITIES     CurrentNicSwitchCapabilities;
  PNDIS_SRIOV_CAPABILITIES          HardwareSriovCapabilities;
  PNDIS_SRIOV_CAPABILITIES          CurrentSriovCapabilities;
  PNDIS_QOS_CAPABILITIES            HardwareQosCapabilities;
  PNDIS_QOS_CAPABILITIES            CurrentQosCapabilities;
  PNDIS_GFT_OFFLOAD_CAPABILITIES    HardwareGftOffloadCapabilities;
  PNDIS_GFT_OFFLOAD_CAPABILITIES    CurrentGftOffloadCapabilities;
} NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES, *PNDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES;

구성원

Header

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 구조체의 NDIS_OBJECT_HEADER 구조체입니다. 드라이버는 Header가 지정하는 구조체의 Type 멤버를 NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 설정합니다.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 구조체의 버전을 나타내려면 Revision 멤버를 다음 값 중 하나로 설정합니다.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3

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

Size 멤버를 NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3 설정합니다.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2

NDIS 6.20용 HardwareReceiveFilterCapabilities, CurrentReceiveFilterCapabilities, HardwareNicSwitchCapabilities 및 CurrentNicSwitchCapabilities 멤버가 추가되었습니다.

Size 멤버를 NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2 설정합니다.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1

NDIS 6.1의 원래 버전입니다.

Size 멤버를 NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1 설정합니다.

HDSplitAttributes

네트워크 어댑터에서 제공하는 헤더-데이터 분할 기능을 나타내는 NDIS_HD_SPLIT_ATTRIBUTES 구조체에 대한 포인터입니다. 네트워크 어댑터가 헤더-데이터 분할 기능을 지원하지 않는 경우 HDSplitAttributes를 NULL로 설정합니다.

HardwareReceiveFilterCapabilities

NDIS_RECEIVE_FILTER_CAPABILITIES 구조체에 대한 포인터입니다. 이 구조는 네트워크 어댑터의 하드웨어 수신 필터링 기능을 지정합니다. 네트워크 어댑터가 수신 필터링을 지원하지 않는 경우 이 값은 NULL 일 수 있습니다.

경고 이 멤버가 NULL로 설정되지 않은 경우 CurrentReceiveFilterCapabilities 멤버를 NULL로 설정하면 안 됩니다.

CurrentReceiveFilterCapabilities

NDIS_RECEIVE_FILTER_CAPABILITIES 구조체에 대한 포인터입니다. 이 구조는 네트워크 어댑터에서 현재 사용하도록 설정된 수신 필터링 기능을 지정합니다. 네트워크 어댑터가 수신 필터링을 지원하지 않는 경우 이 값은 NULL 일 수 있습니다.

경고 이 멤버가 NULL로 설정되지 않은 경우 HardwareReceiveFilterCapabilities 멤버를 NULL로 설정하면 안 됩니다.

HardwareNicSwitchCapabilities

NDIS_NIC_SWITCH_CAPABILITIES 구조체에 대한 포인터입니다. 이 구조는 네트워크 어댑터의 하드웨어 NIC 스위치 기능을 지정합니다. 네트워크 어댑터가 NIC 스위치 기능을 지원하지 않거나 필터링을 수신하지 않는 경우 이 값은 NULL 일 수 있습니다.

경고 이 멤버가 NULL로 설정되지 않은 경우 CurrentNicSwitchCapabilities 멤버를 NULL로 설정하면 안 됩니다.

CurrentNicSwitchCapabilities

NDIS_NIC_SWITCH_CAPABILITIES 구조체에 대한 포인터입니다. 이 구조체는 네트워크 어댑터에서 현재 사용하도록 설정된 NIC 스위치 기능을 지정합니다. 네트워크 어댑터가 NIC 스위치 기능을 지원하지 않거나 필터링을 수신하지 않는 경우 이 값은 NULL 일 수 있습니다.

경고 이 멤버가 NULL로 설정되지 않은 경우 HardwareNicSwitchCapabilities 멤버를 NULL로 설정하면 안 됩니다.

HardwareSriovCapabilities

NDIS_SRIOV_CAPABILITIES 구조체에 대한 포인터입니다. 이 구조는 네트워크 어댑터 하드웨어의 단일 루트 I/O 가상화(SR-IOV) 기능을 지정합니다. 네트워크 어댑터가 SR-IOV를 지원하지 않는 경우 이 값은 NULL 일 수 있습니다.

SR-IOV에 대한 자세한 내용은 SR-IOV(단일 루트 I/O 가상화)를 참조하세요.

참고 이 멤버가 NULL로 설정되지 않은 경우 CurrentSriovCapabilities, HardwareNicSwitchCapabilities 및 CurrentNicSwitchCapabilities 멤버를 NULL로 설정하면 안 됩니다.

CurrentSriovCapabilities

NDIS_SRIOV_CAPABILITIES 구조체에 대한 포인터입니다. 이 구조체는 네트워크 어댑터에서 현재 사용하도록 설정된 SR-IOV 기능을 지정합니다. 네트워크 어댑터가 SR-IOV를 지원하지 않는 경우 이 값은 NULL 일 수 있습니다.

참고 이 멤버가 NULL로 설정되지 않은 경우 HardwareSriovCapabilities, HardwareNicSwitchCapabilities 및 CurrentNicSwitchCapabilities 멤버를 NULL로 설정하면 안 됩니다.

HardwareQosCapabilities

NDIS_QOS_CAPABILITIES 구조체에 대한 포인터입니다. 이 구조는 네트워크 어댑터가 IEEE 802.1 DCB(데이터 센터 브리징) 인터페이스를 통해 NDIS(서비스 품질)를 지원하는 하드웨어 기능을 지정합니다. 네트워크 어댑터가 DCB에 대한 NDIS QoS 하드웨어 기능을 지원하지 않는 경우 이 값은 NULL 일 수 있습니다.

자세한 내용은 데이터 센터 브리징에 대한 NDIS QoS를 참조하세요.

참고 이 멤버가 NULL로 설정되지 않은 경우 CurrentQosCapabilities 멤버를 NULL로 설정하면 안 됩니다.

CurrentQosCapabilities

NDIS_QOS_CAPABILITIES 구조체에 대한 포인터입니다. 이 구조는 DCB 인터페이스를 통해 NDIS QoS용 네트워크 어댑터에서 현재 사용하도록 설정된 하드웨어 기능을 지정합니다. 네트워크 어댑터가 DCB에 대한 NDIS QoS 하드웨어 기능을 지원하지 않는 경우 이 값은 NULL 일 수 있습니다.

어댑터가 NDIS QoS capabilties를 지원하지만 이러한 기능이 비활성화된 경우 미니포트 드라이버는 헤더 멤버를 제외한 NDIS_QOS_CAPABILITIES 구조체의 모든 멤버를 0으로 설정해야 합니다.

참고 이 멤버가 NULL로 설정되지 않은 경우 HardwareQosCapabilities 멤버를 NULL로 설정하면 안 됩니다.

HardwareGftOffloadCapabilities

CurrentGftOffloadCapabilities

설명

기본 네트워크 어댑터의 하드웨어 지원 기능을 등록하기 위해 미니포트 드라이버는 MiniportInitializeEx 함수에서 NdisMSetMiniportAttributes 함수를 호출합니다. 드라이버는 초기화된 NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES 구조를 이 함수의 MiniportAttributes 매개 변수에 전달합니다.