estructura NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES (ndis.h)

Un controlador de minipuerto NDIS configura una estructura de NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES para definir los atributos generales del controlador de minipuerto que están asociados a un adaptador de minipuerto.

Sintaxis

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;

Miembros

Header

Estructura NDIS_OBJECT_HEADER de la estructura de NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES . Establezca el miembro Type de la estructura que Header especifica para NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES.

Para indicar la versión de la estructura de NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES , establezca el miembro Revision en uno de los valores siguientes:

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2

Se agregó el miembro PowerManagementCapabilitiesEx para NDIS 6.2.

Establezca el miembro Size en NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2.

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1

Versión original para NDIS 6.0 y NDIS 6,1.

Establezca el miembro Size en NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1.

Flags

Reservado para NDIS.

MediaType

Tipo NdisMediumXxx que admite el adaptador de minipuerto. Para obtener más información, consulte NDIS_MEDIUM.

PhysicalMediumType

Tipo medio físico para el adaptador de minipuerto. Para obtener más información, consulte OID_GEN_PHYSICAL_MEDIUM

MtuSize

Tamaño máximo de la unidad de transferencia (MTU). Para obtener más información, consulte OID_GEN_MAXIMUM_FRAME_SIZE.

MaxXmitLinkSpeed

Velocidad máxima del enlace de transmisión del adaptador en bits por segundo. Para obtener más información, consulte OID_GEN_MAX_LINK_SPEED.

XmitLinkSpeed

Velocidad de enlace de transmisión actual del adaptador en bits por segundo. Para obtener más información, consulte OID_GEN_LINK_SPEED_EX.

MaxRcvLinkSpeed

Velocidad máxima del vínculo de recepción del adaptador en bits por segundo. Para obtener más información, consulte OID_GEN_MAX_LINK_SPEED.

RcvLinkSpeed

Velocidad del vínculo de recepción actual del adaptador en bits por segundo. Para obtener más información, consulte OID_GEN_LINK_SPEED_EX.

MediaConnectState

Estado de conexión de medios para el adaptador de minipuerto. Para obtener más información, vea OID_GEN_MEDIA_CONNECT_STATUS_EX.

MediaDuplexState

Estado dúplex multimedia para el adaptador de minipuerto. Para obtener más información, consulte OID_GEN_MEDIA_DUPLEX_STATE.

LookaheadSize

Tamaño de lookahead para el adaptador de minipuerto. Para obtener más información, consulte OID_GEN_CURRENT_LOOKAHEAD.

PowerManagementCapabilities

Las funcionalidades Plug and Play (PnP) del adaptador de minipuerto. Para obtener más información sobre las funcionalidades de PnP, consulte OID_PNP_CAPABILITIES. Si el adaptador de minipuerto no es compatible con la administración de energía, el controlador de minipuerto debe establecer PowerManagementCapabilities en NULL. En su lugar, los controladores NDIS 6.20 y versiones posteriores deben usar el miembro PowerManagementCapabilitiesEx .

MacOptions

Las opciones mac del adaptador de minipuerto. Para obtener más información, consulte OID_GEN_MAC_OPTIONS.

SupportedPacketFilters

Marcas de filtro de paquetes para el adaptador de minipuerto. Para obtener más información, vea OID_GEN_SUPPORTED_PACKET_FILTERS.

MaxMulticastListSize

Tamaño de la lista de direcciones de multidifusión para el adaptador de minipuerto. Para obtener más información, vea OID_802_3_MAXIMUM_LIST_SIZE.

MacAddressLength

Longitud de la dirección MAC, en bytes. La longitud de la dirección MAC es específica del tipo de medio.

PermanentMacAddress

Dirección MAC permanente. Por ejemplo, el OID de OID_802_3_PERMANENT_ADDRESS especifica la dirección MAC permanente para los controladores IEEE 802.3.

CurrentMacAddress

La dirección MAC actual. Por ejemplo, el OID de OID_802_3_CURRENT_ADDRESS especifica la dirección MAC actual para los controladores IEEE 802.3.

RecvScaleCapabilities

Funcionalidades de escalado lateral de recepción (RSS) de la NIC. Si el adaptador de minipuerto no admite la característica RSS, establezca RecvScaleCapabilities en NULL. Para obtener más información sobre RSS, consulte OID_GEN_RECEIVE_SCALE_CAPABILITIES.

AccessType

Tipo de acceso de interfaz de red NDIS NET_IF_ACCESS_TYPE.

DirectionType

Un NET_IF_DIRECTION_TYPE tipo de dirección de la interfaz de red NDIS.

ConnectionType

Un NET_IF_CONNECTION_TYPE tipo de conexión de interfaz de red NDIS.

IfType

Tipo de interfaz de la autoridad de números asignados a Internet (IANA). Por ejemplo, IF_TYPE_ETHERNET_CSMACD (6) es el valor de IfType asignado a cualquier interfaz similar a Ethernet. Para obtener una lista si los tipos de interfaz, consulte Tipos de interfaz NDIS.

IfConnectorPresent

Valor booleano que indica si hay un conector presente. Establezca este valor en TRUE si hay un adaptador físico.

SupportedStatistics

Estadísticas admitidas.

Nota Los controladores NDIS 6.0 deben admitir todas las estadísticas y deben notificarlas cuando se consultan los controladores para OID_GEN_STATISTICS.
 
El valor es el or bit a bit de las marcas siguientes:

NDIS_STATISTICS_DIRECTED_FRAMES_RCV_SUPPORTED

Los datos del miembro ifHCInUcastPkts son válidos .

NDIS_STATISTICS_MULTICAST_FRAMES_RCV_SUPPORTED

Los datos del miembro ifHCInMulticastPkts de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_BROADCAST_FRAMES_RCV_SUPPORTED

Los datos del miembro ifHCInBroadcastPkts de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_BYTES_RCV_SUPPORTED

Los datos del miembro ifHCInOctets de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_RCV_DISCARDS_SUPPORTED

Los datos del miembro ifInDiscards de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_RCV_ERROR_SUPPORTED

Los datos del miembro ifInErrors de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_DIRECTED_FRAMES_XMIT_SUPPORTED

Los datos del miembro ifHCOutUcastPkts de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_MULTICAST_FRAMES_XMIT_SUPPORTED

Los datos del miembro ifHCOutMulticastPkts de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_BROADCAST_FRAMES_XMIT_SUPPORTED

Los datos del miembro ifHCOutBroadcastPkts de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_BYTES_XMIT_SUPPORTED

Los datos del miembro ifHCOutOctets de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_XMIT_ERROR_SUPPORTED

Los datos del miembro ifOutErrors de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_XMIT_DISCARDS_SUPPORTED

Los datos del miembro ifOutDiscards de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_DIRECTED_BYTES_RCV_SUPPORTED

Los datos del miembro ifHCInUcastOctets de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_MULTICAST_BYTES_RCV_SUPPORTED

Los datos del miembro ifHCInMulticastOctets de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_BROADCAST_BYTES_RCV_SUPPORTED

Los datos del miembro ifHCInBroadcastOctets de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_DIRECTED_BYTES_XMIT_SUPPORTED

Los datos del miembro ifHCOutUcastOctets de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_MULTICAST_BYTES_XMIT_SUPPORTED

Los datos del miembro ifHCOutMulticastOctets de NDIS_STATISTICS_INFO son válidos.

NDIS_STATISTICS_BROADCAST_BYTES_XMIT_SUPPORTED

Los datos del miembro ifHCOutBroadcastOctets de NDIS_STATISTICS_INFO son válidos.

SupportedPauseFunctions

La compatibilidad con los fotogramas de pausa IEEE 802.3 como una de las siguientes funciones de pausa:

NdisPauseFunctionsUnsupported

Indica que el adaptador o asociado de vínculo no admite fotogramas de pausa.

NdisPauseFunctionsSendOnly

Indica que el adaptador y el asociado de vínculo solo admiten el envío de fotogramas de pausa desde el adaptador al asociado de vínculo.

NdisPauseFunctionsReceiveOnly

Indica que el adaptador y el asociado de vínculo solo admiten el envío de fotogramas de pausa desde el asociado de vínculo al adaptador.

NdisPauseFunctionsSendAndReceive

Indica que el adaptador y el asociado de vínculo admiten el envío y la recepción de fotogramas de pausa en instrucciones transint y receive.

NdisPauseFunctionsUnknown

Indica que la negociación de fotogramas de pausa está en curso. La compatibilidad con fotogramas de pausa que proporciona el asociado de vínculo es desconocida.

DataBackFillSize

Tamaño de reposición de datos requerido, en bytes, del controlador.

ContextBackFillSize

Tamaño de reposición de contexto necesario, en bytes, del controlador.

SupportedOidList

Lista de OID que admite el controlador de minipuerto. Para obtener más información, consulte OID_GEN_SUPPORTED_LIST.

SupportedOidListLength

Tamaño, en bytes, de la lista de OID en SupportedOidList .

AutoNegotiationFlags

La configuración de negociación automática para el adaptador de minipuerto. Este miembro se crea a partir de un or bit a bit de las marcas siguientes:

El adaptador ha negociado automáticamente la velocidad del enlace de transmisión con el asociado de vínculo.

El adaptador ha negociado automáticamente la velocidad del vínculo de recepción con el asociado de vínculo.

El adaptador ha negociado automáticamente el estado dúplex con el asociado de vínculo.

El adaptador ha negociado automáticamente las funciones de pausa con el asociado de vínculo.

PowerManagementCapabilitiesEx

Puntero a una estructura de NDIS_PM_CAPABILITIES . Esta estructura especifica las capacidades de administración de energía del adaptador de minipuerto. Este miembro es obligatorio para los controladores NDIS 6.20 y versiones posteriores.

Comentarios

Un controlador de minipuerto pasa un puntero a una estructura de NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES en el parámetro MiniportAttributes del Función NdisMSetMiniportAttributes . Un controlador de minipuerto llama a NdisMSetMiniportAttributes desde su función MiniportInitializeEx durante la inicialización. Los controladores de minipuerto deben establecer estos atributos después de establecer los atributos de registro en . NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES estructura y antes de establecer cualquier otro atributo. Establecer este atributo es obligatorio.

Requisitos

   
Cliente mínimo compatible Se admite en NDIS 6.0 y versiones posteriores.
Header ndis.h (incluya Ndis.h)

Consulte también

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_GEN_SUPPORTED_PACKET_FILTERS

OID_PNP_CAPABILITIES