estrutura NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES (ndis.h)

Artigo
04/18/2024

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 membro Type da estrutura especificada por Header como 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

Vários membros foram adicionados para o NDIS 6.30.

Defina o membro Size como NDIS_SIZEOF_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_3.

NDIS_MINIPORT_ADAPTER_HARDWARE_ASSIST_ATTRIBUTES_REVISION_2

Foram adicionados os membros HardwareReceiveFilterCapabilities, CurrentReceiveFilterCapabilities, HardwareNicSwitchCapabilities e CurrentNicSwitchCapabilities para NDIS 6.20.

Defina o membro Size 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 Size 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 como 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 der 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 der 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 der 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 der 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 SR-IOV (virtualização de E/S de raiz única) 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 SR-IOV (Virtualização de E/S de Raiz Única).

Nota Se esse membro não estiver definido como NULL, os membros CurrentSriovCapabilities, HardwareNicSwitchCapabilities e CurrentNicSwitchCapabilities não deverão ser definidos como NULL.

CurrentSriovCapabilities

Um ponteiro para uma estrutura NDIS_SRIOV_CAPABILITIES . Essa estrutura especifica os recursos 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.

Nota Se esse membro não estiver definido como NULL, os membros HardwareSriovCapabilities, HardwareNicSwitchCapabilities e CurrentNicSwitchCapabilities não deverão ser definidos como NULL.

HardwareQosCapabilities

Um ponteiro para uma estrutura NDIS_QOS_CAPABILITIES . Essa estrutura especifica os recursos de hardware aos quais o adaptador de rede dá suporte para QoS (qualidade de serviço) do NDIS na interface dcidging (DCB) do Data Center do IEEE 802.1. Esse valor poderá ser NULL se o adaptador de rede não der suporte a recursos de hardware de QoS NDIS para DCB.

Para obter mais informações, consulte QoS do NDIS para ponte do Data Center.

Nota 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 que estão atualmente habilitados no adaptador de rede para QoS NDIS pela interface DCB. Esse valor poderá ser NULL se o adaptador de rede não der suporte a recursos de hardware de QoS 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 Header ) como zero.

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

HardwareGftOffloadCapabilities

CurrentGftOffloadCapabilities

Comentários

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.