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 multimedia 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.
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[NDIS_MAX_PHYS_ADDRESS_LENGTH]
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[NDIS_MAX_PHYS_ADDRESS_LENGTH]
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.
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:
NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED
El adaptador ha negociado automáticamente la velocidad del enlace de transmisión con el asociado de enlace.
NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
El adaptador ha negociado automáticamente la velocidad del vínculo de recepción con el asociado de vínculo.
NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
El adaptador ha negociado automáticamente el estado dúplex con el asociado de vínculo.
NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
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
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Se admite en NDIS 6.0 y versiones posteriores. |
| Encabezado | ndis.h (incluya Ndis.h) |
Consulte también
NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTESComentarios
Próximamente: A lo largo de 2024 iremos eliminando gradualmente GitHub Issues como mecanismo de comentarios sobre el contenido y lo sustituiremos por un nuevo sistema de comentarios. Para más información, vea: https://aka.ms/ContentUserFeedback.
Enviar y ver comentarios de