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.
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:
NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED
O adaptador negociou automaticamente a velocidade do link de transmissão com o parceiro de link.
NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
O adaptador negociou automaticamente a velocidade de vínculo de recebimento com o parceiro de link.
NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
O adaptador negociou automaticamente o estado duplex com o parceiro de link.
NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
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) |