Compartilhar via


estrutura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES (ndis.h)

Um driver de miniporto NDIS configura uma estrutura de NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES para definir os atributos gerais de driver de miniport que estão associados a um adaptador de miniporte.

Sintaxe

typedef struct _NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES {
  NDIS_OBJECT_HEADER               Header;
  ULONG                            Flags;
  NDIS_MEDIUM                      MediaType;
  NDIS_PHYSICAL_MEDIUM             PhysicalMediumType;
  ULONG                            MtuSize;
  ULONG64                          MaxXmitLinkSpeed;
  ULONG64                          XmitLinkSpeed;
  ULONG64                          MaxRcvLinkSpeed;
  ULONG64                          RcvLinkSpeed;
  NDIS_MEDIA_CONNECT_STATE         MediaConnectState;
  NDIS_MEDIA_DUPLEX_STATE          MediaDuplexState;
  ULONG                            LookaheadSize;
  PNDIS_PNP_CAPABILITIES           PowerManagementCapabilities;
  ULONG                            MacOptions;
  ULONG                            SupportedPacketFilters;
  ULONG                            MaxMulticastListSize;
  USHORT                           MacAddressLength;
  UCHAR                            PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  UCHAR                            CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH];
  PNDIS_RECEIVE_SCALE_CAPABILITIES RecvScaleCapabilities;
  NET_IF_ACCESS_TYPE               AccessType;
  NET_IF_DIRECTION_TYPE            DirectionType;
  NET_IF_CONNECTION_TYPE           ConnectionType;
  NET_IFTYPE                       IfType;
  BOOLEAN                          IfConnectorPresent;
  ULONG                            SupportedStatistics;
  ULONG                            SupportedPauseFunctions;
  ULONG                            DataBackFillSize;
  ULONG                            ContextBackFillSize;
  PNDIS_OID                        SupportedOidList;
  ULONG                            SupportedOidListLength;
  ULONG                            AutoNegotiationFlags;
  PNDIS_PM_CAPABILITIES            PowerManagementCapabilitiesEx;
} NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES, *PNDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES;

Membros

Header

A estrutura NDIS_OBJECT_HEADER para a estrutura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES . Defina o membro Type da estrutura especificada por Header como NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES.

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

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2

Adicionado o membro PowerManagementCapabilitiesEx para NDIS 6.2.

Defina o membro Size como NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2.

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1

Versão original para NDIS 6.0 e NDIS 6,1.

Defina o membro Size como NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1.

Flags

Reservado para NDIS.

MediaType

O tipo NdisMediumXxx que o adaptador de miniporto dá suporte. Para obter mais informações, consulte NDIS_MEDIUM.

PhysicalMediumType

O tipo médio físico para o adaptador de miniporto. Para obter mais informações, consulte OID_GEN_PHYSICAL_MEDIUM

MtuSize

O tamanho máximo da MTU (unidade de transferência). Para obter mais informações, consulte OID_GEN_MAXIMUM_FRAME_SIZE.

MaxXmitLinkSpeed

A velocidade máxima do link de transmissão do adaptador em bits por segundo. Para obter mais informações, consulte OID_GEN_MAX_LINK_SPEED.

XmitLinkSpeed

A velocidade de link de transmissão atual do adaptador em bits por segundo. Para obter mais informações, consulte OID_GEN_LINK_SPEED_EX.

MaxRcvLinkSpeed

A velocidade máxima de link de recebimento do adaptador em bits por segundo. Para obter mais informações, consulte OID_GEN_MAX_LINK_SPEED.

RcvLinkSpeed

A velocidade de link de recebimento atual do adaptador em bits por segundo. Para obter mais informações, consulte OID_GEN_LINK_SPEED_EX.

MediaConnectState

O estado de conexão de mídia para o adaptador de miniport. Para obter mais informações, consulte OID_GEN_MEDIA_CONNECT_STATUS_EX.

MediaDuplexState

O estado duplex de mídia para o adaptador de miniport. Para obter mais informações, consulte OID_GEN_MEDIA_DUPLEX_STATE.

LookaheadSize

O tamanho do lookahead para o adaptador de miniport. Para obter mais informações, consulte OID_GEN_CURRENT_LOOKAHEAD.

PowerManagementCapabilities

Os recursos de Plug and Play (PnP) do adaptador de miniport. Para obter mais informações sobre recursos PnP, consulte OID_PNP_CAPABILITIES. Se o adaptador de miniporta não estiver ciente do gerenciamento de energia, o driver de miniporte deverá definir PowerManagementCapabilities como NULL. Os drivers NDIS 6.20 e posteriores devem usar o membro PowerManagementCapabilitiesEx .

MacOptions

As opções mac para o adaptador de miniporto. Para obter mais informações, consulte OID_GEN_MAC_OPTIONS.

SupportedPacketFilters

Os sinalizadores de filtro de pacote para o adaptador de miniport.

MaxMulticastListSize

O tamanho da lista de endereços multicast para o adaptador de miniport. Para obter mais informações, consulte OID_802_3_MAXIMUM_LIST_SIZE.

MacAddressLength

O comprimento do endereço MAC, em bytes. O comprimento do endereço MAC é específico para o tipo de mídia.

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

O endereço MAC permanente. Por exemplo, o OID_802_3_PERMANENT_ADDRESS OID especifica o endereço MAC permanente para drivers IEEE 802.3.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

O endereço MAC atual. Por exemplo, o OID_802_3_CURRENT_ADDRESS OID especifica o endereço MAC atual para drivers IEEE 802.3.

RecvScaleCapabilities

Os recursos de RSS (dimensionamento lateral de recebimento) da NIC. Se o adaptador de miniporte não der suporte ao recurso RSS, defina RecvScaleCapabilities como NULL. Para obter mais informações sobre o RSS, consulte OID_GEN_RECEIVE_SCALE_CAPABILITIES.

AccessType

Um tipo de acesso de interface de rede NDIS NET_IF_ACCESS_TYPE.

DirectionType

Um tipo de direção de interface de rede NDIS NET_IF_DIRECTION_TYPE.

ConnectionType

Um tipo de conexão de interface de rede NDIS NET_IF_CONNECTION_TYPE.

IfType

O tipo de interface IANA (Internet Assigned Numbers Authority). Por exemplo, IF_TYPE_ETHERNET_CSMACD (6) é o valor de IfType atribuído a qualquer interface semelhante a Ethernet. Para obter uma lista se tipos de interface, consulte Tipos de interface NDIS.

IfConnectorPresent

Um valor booliano que indica se um conector está presente. Defina esse valor como TRUE se houver um adaptador físico.

SupportedStatistics

As estatísticas com suporte.

Nota Os drivers NDIS 6.0 devem dar suporte a todas as estatísticas e devem reportá-las quando os drivers são consultados para OID_GEN_STATISTICS.
 
O valor é o OR bit a bit dos seguintes sinalizadores:

NDIS_STATISTICS_DIRECTED_FRAMES_RCV_SUPPORTED

Os dados no membro ifHCInUcastPkts são válidos .

NDIS_STATISTICS_MULTICAST_FRAMES_RCV_SUPPORTED

Os dados no membro ifHCInMulticastPkts de NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_BROADCAST_FRAMES_RCV_SUPPORTED

Os dados no membro ifHCInBroadcastPkts de NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_BYTES_RCV_SUPPORTED

Os dados no membro ifHCInOctets de NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_RCV_DISCARDS_SUPPORTED

Os dados no membro ifInDiscards do NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_RCV_ERROR_SUPPORTED

Os dados no membro ifInErrors de NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_DIRECTED_FRAMES_XMIT_SUPPORTED

Os dados no membro ifHCOutUcastPkts de NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_MULTICAST_FRAMES_XMIT_SUPPORTED

Os dados no membro ifHCOutMulticastPkts de NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_BROADCAST_FRAMES_XMIT_SUPPORTED

Os dados no membro ifHCOutBroadcastPkts de NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_BYTES_XMIT_SUPPORTED

Os dados no membro ifHCOutOctets de NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_XMIT_ERROR_SUPPORTED

Os dados no membro ifOutErrors de NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_XMIT_DISCARDS_SUPPORTED

Os dados no membro ifOutDiscards do NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_DIRECTED_BYTES_RCV_SUPPORTED

Os dados no membro ifHCInUcastOctets de NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_MULTICAST_BYTES_RCV_SUPPORTED

Os dados no membro ifHCInMulticastOctets de NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_BROADCAST_BYTES_RCV_SUPPORTED

Os dados no membro ifHCInBroadcastOctets de NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_DIRECTED_BYTES_XMIT_SUPPORTED

Os dados no membro ifHCOutUcastOctets de NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_MULTICAST_BYTES_XMIT_SUPPORTED

Os dados no membro ifHCOutMulticastOctets de NDIS_STATISTICS_INFO são válidos.

NDIS_STATISTICS_BROADCAST_BYTES_XMIT_SUPPORTED

Os dados no membro ifHCOutBroadcastOctets de NDIS_STATISTICS_INFO são válidos.

SupportedPauseFunctions

Suporte para os quadros de pausa do IEEE 802.3 como uma das seguintes funções de pausa:

NdisPauseFunctionsUnsupported

Indica que o adaptador ou parceiro de link não dá suporte a quadros de pausa.

NdisPauseFunctionsSendOnly

Indica que o adaptador e o parceiro de link só dão suporte ao envio de quadros de pausa do adaptador para o parceiro de link.

NdisPauseFunctionsReceiveOnly

Indica que o adaptador e o parceiro de link só dão suporte ao envio de quadros de pausa do parceiro de link para o adaptador

NdisPauseFunctionsSendAndReceive

Indica que o adaptador e o parceiro de link dão suporte ao envio e ao recebimento de quadros de pausa em direções transitórias e de recebimento.

NdisPauseFunctionsUnknown

Indica que a negociação de quadro de pausa está em andamento. O suporte ao quadro de pausa que o parceiro de link fornece é desconhecido.

DataBackFillSize

O tamanho de backfill de dados necessário, em bytes, do driver.

ContextBackFillSize

O tamanho de arquivo invertido de contexto necessário, em bytes, do driver.

SupportedOidList

Uma lista de OIDs compatíveis com o driver de miniporto. Para obter mais informações, consulte OID_GEN_SUPPORTED_LIST.

SupportedOidListLength

O tamanho, em bytes, da lista OID em SupportedOidList .

AutoNegotiationFlags

As configurações de negociação automática para o adaptador de miniport. Esse membro é criado a partir de um OR bit a bit dos seguintes sinalizadores:

O adaptador negociou automaticamente a velocidade do link de transmissão com o parceiro de link.

O adaptador negociou automaticamente a velocidade de vínculo de recebimento com o parceiro de link.

O adaptador negociou automaticamente o estado duplex com o parceiro de link.

O adaptador negociou automaticamente as funções de pausa com o parceiro de link.

PowerManagementCapabilitiesEx

Um ponteiro para uma estrutura NDIS_PM_CAPABILITIES . Essa estrutura especifica os recursos de gerenciamento de energia do adaptador de miniporte. Esse membro é obrigatório para drivers NDIS 6.20 e posteriores.

Comentários

Um driver de miniporte passa um ponteiro para uma estrutura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES no parâmetro MiniportAttributes do Função NdisMSetMiniportAttributes . Um driver de miniporto chama NdisMSetMiniportAttributes de sua função MiniportInitializeEx durante a inicialização. Os drivers de miniporte devem definir esses atributos depois de definirem os atributos de registro no NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES estrutura e antes de definirem outros atributos. A definição desses atributos é obrigatória.

Requisitos

Requisito Valor
Cliente mínimo com suporte Com suporte no NDIS 6.0 e posterior.
Cabeçalho ndis.h (inclua Ndis.h)

Confira também

MiniportInitializeEx

NDIS_MEDIUM

NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES

NDIS_OBJECT_HEADER

NDIS_PM_CAPABILITIES

NDIS_STATISTICS_INFO

NET_IF_ACCESS_TYPE

NET_IF_CONNECTION_TYPE

NET_IF_DIRECTION_TYPE

NdisMSetMiniportAttributes

OID_802_3_CURRENT_ADDRESS

OID_802_3_MAXIMUM_LIST_SIZE

OID_802_3_PERMANENT_ADDRESS

OID_GEN_CURRENT_LOOKAHEAD

OID_GEN_LINK_SPEED_EX

OID_GEN_MAC_OPTIONS

OID_GEN_MAXIMUM_FRAME_SIZE

OID_GEN_MAX_LINK_SPEED

OID_GEN_MEDIA_CONNECT_STATUS_EX

OID_GEN_MEDIA_DUPLEX_STATE

OID_GEN_PHYSICAL_MEDIUM

OID_GEN_STATISTICS

OID_GEN_SUPPORTED_LIST

OID_PNP_CAPABILITIES