estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES (ndis.h)

Artigo
02/07/2025

A estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES especifica os atributos assistidos por hardware do adaptador de rede.

Sintaxe

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;

Membros

Header

A estrutura NDIS_OBJECT_HEADER para a estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES. O driver define o Type membro da estrutura que header especifica para NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES.

Para indicar a versão da estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES, defina o membro Revision como um dos seguintes valores:

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3

Foram adicionados vários membros para o NDIS 6.30.

Defina o membro tamanho do como NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2

Adicionadas as HardwareReceiveFilterCapabilities, CurrentReceiveFilterCapabilities, HardwareNicSwitchCapabilitiese CurrentNicSwitchCapabilities membros para NDIS 6.20.

Defina o membro tamanho como NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1

Versão original do NDIS 6.1.

Defina o membro tamanho do como NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_1.

HDSplitAttributes

Um ponteiro para uma estrutura NDIS_HD_SPLIT_ATTRIBUTES que representa os recursos de divisão de dados de cabeçalho fornecidos pelo adaptador de rede. Se o adaptador de rede não der suporte ao recurso de divisão de dados de cabeçalho, defina HDSplitAttributes para NULL.

HardwareReceiveFilterCapabilities

Um ponteiro para um NDIS_RECEIVE_FILTER_CAPABILITIES estrutura. Essa estrutura especifica os recursos de filtragem de recebimento de hardware do adaptador de rede. Esse valor poderá ser NULL se o adaptador de rede não oferecer suporte à filtragem de recebimento.

Aviso Se esse membro não estiver definido como NULL, o membro CurrentReceiveFilterCapabilities não deverá ser definido como NULL.

CurrentReceiveFilterCapabilities

Um ponteiro para uma estrutura NDIS_RECEIVE_FILTER_CAPABILITIES. Essa estrutura especifica os recursos de filtragem de recebimento que estão atualmente habilitados no adaptador de rede. Esse valor poderá ser NULL se o adaptador de rede não oferecer suporte à filtragem de recebimento.

Aviso Se esse membro não estiver definido como NULL, o membro HardwareReceiveFilterCapabilities não deverá ser definido como NULL.

HardwareNicSwitchCapabilities

Um ponteiro para um NDIS_NIC_SWITCH_CAPABILITIES estrutura. Essa estrutura especifica os recursos de comutador NIC de hardware do adaptador de rede. Esse valor poderá ser NULL se o adaptador de rede não oferecer suporte a recursos de comutador NIC ou filtragem de recebimento.

Aviso Se esse membro não estiver definido como NULL, o membro CurrentNicSwitchCapabilities não deverá ser definido como NULL.

CurrentNicSwitchCapabilities

Um ponteiro para uma estrutura NDIS_NIC_SWITCH_CAPABILITIES. Essa estrutura especifica os recursos de comutador NIC que estão atualmente habilitados no adaptador de rede. Esse valor poderá ser NULL se o adaptador de rede não oferecer suporte a recursos de comutador NIC ou filtragem de recebimento.

Aviso Se esse membro não estiver definido como NULL, o membro HardwareNicSwitchCapabilities não deverá ser definido como NULL.

HardwareSriovCapabilities

Um ponteiro para uma estrutura NDIS_SRIOV_CAPABILITIES. Essa estrutura especifica os recursos de virtualização de E/S raiz única (SR-IOV) do hardware do adaptador de rede. Esse valor poderá ser NULL se o adaptador de rede não der suporte a SR-IOV.

Para obter mais informações sobre SR-IOV, consulte de Virtualização de E/S de Raiz Única (SR-IOV).

Observação Se esse membro não estiver definido como NULL, os CurrentSriovCapabilities, HardwareNicSwitchCapabilitiese CurrentNicSwitchCapabilities membros não deverão ser definidos como NULL.

CurrentSriovCapabilities

Um ponteiro para uma estrutura NDIS_SRIOV_CAPABILITIES. Essa estrutura especifica os recursos de SR-IOV que estão atualmente habilitados no adaptador de rede. Esse valor poderá ser NULL se o adaptador de rede não der suporte a SR-IOV.

Observação Se esse membro não estiver definido como NULL, os HardwareSriovCapabilities, HardwareNicSwitchCapabilitiese CurrentNicSwitchCapabilities membros não deverão ser definidos como NULL.

HardwareQosCapabilities

Um ponteiro para uma estrutura NDIS_QOS_CAPABILITIES. Essa estrutura especifica os recursos de hardware que o adaptador de rede dá suporte para QoS (qualidade de serviço) do NDIS em relação à interface DCB (Ponte de Data Center) do IEEE 802.1. Esse valor poderá ser NULL se o adaptador de rede não oferecer suporte a recursos de hardware de QoS do NDIS para DCB.

Para obter mais informações, consulte NDIS QoS for Data Center Bridging.

Observação Se esse membro não estiver definido como NULL, o membro CurrentQosCapabilities não deverá ser definido como NULL.

CurrentQosCapabilities

Um ponteiro para uma estrutura NDIS_QOS_CAPABILITIES. Essa estrutura especifica os recursos de hardware atualmente habilitados no adaptador de rede para NDIS QoS pela interface DCB. Esse valor poderá ser NULL se o adaptador de rede não oferecer suporte a recursos de hardware de QoS do NDIS para DCB.

Se o adaptador der suporte a recursos de QoS do NDIS, mas esses recursos estiverem desabilitados, o driver de miniporto deverá definir todos os membros da estrutura de NDIS_QOS_CAPABILITIES (com exceção do membro de Cabeçalho) como zero.

Observação Se esse membro não estiver definido como NULL, o membro HardwareQosCapabilities não deverá ser definido como NULL.

HardwareGftOffloadCapabilities

CurrentGftOffloadCapabilities

Observações

Para registrar os recursos assistidos por hardware do adaptador de rede subjacente, o driver de miniporto chama o função NdisMSetMiniportAttributes de sua função MiniportInitializeEx. O driver passa uma estrutura de NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES inicializada para o parâmetro MiniportAttributes dessa função.