Поделиться через

структура NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES (miniportgeneralattributes.h)

An NDIS miniport driver sets up an NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES structure to define the general miniport driver attributes that are associated with a miniport adapter.

Syntax

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;

Members

Header

The NDIS_OBJECT_HEADER structure for the NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES structure. Set the Type member of the structure that Header specifies to NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES.

To indicate the version of the NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES structure, set the Revision member to one of the following values:

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2

Added the PowerManagementCapabilitiesEx member for NDIS 6.2.

Set the Size member to NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2.

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1

Исходная версия для NDIS 6.0 и NDIS 6,1.

Set the Size member to NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1.

Flags

Зарезервировано для NDIS.

MediaType

The NdisMediumXxx type that the miniport adapter supports. For more information, see NDIS_MEDIUM.

PhysicalMediumType

Физический средний тип для минипорт-адаптера. For more information, see OID_GEN_PHYSICAL_MEDIUM

MtuSize

Максимальный размер единицы передачи (MTU). For more information, see OID_GEN_MAXIMUM_FRAME_SIZE.

MaxXmitLinkSpeed

Максимальная скорость передачи адаптера в битах в секунду. For more information, see OID_GEN_MAX_LINK_SPEED.

XmitLinkSpeed

Текущая скорость передачи адаптера в битах в секунду. For more information, see OID_GEN_LINK_SPEED_EX.

MaxRcvLinkSpeed

Максимальная скорость передачи связи адаптера в битах в секунду. For more information, see OID_GEN_MAX_LINK_SPEED.

RcvLinkSpeed

Текущая скорость связи приема адаптера в битах в секунду. For more information, see OID_GEN_LINK_SPEED_EX.

MediaConnectState

Состояние подключения мультимедиа для минипорт-адаптера. Дополнительные сведения см. в разделе OID_GEN_MEDIA_CONNECT_STATUS_EX.

MediaDuplexState

Дуплексное состояние мультимедиа для мини-адаптера. For more information, see OID_GEN_MEDIA_DUPLEX_STATE.

LookaheadSize

Размер lookahead для минипорт-адаптера. For more information, see OID_GEN_CURRENT_LOOKAHEAD.

PowerManagementCapabilities

Возможности минипорт-адаптера Plug and Play (PnP). For more information about PnP capabilities, see OID_PNP_CAPABILITIES. If the miniport adapter is not power management-aware, the miniport driver should set PowerManagementCapabilities to NULL. NDIS 6.20 and later drivers must use the PowerManagementCapabilitiesEx member instead.

MacOptions

Параметры MAC для мини-адаптера. For more information, see OID_GEN_MAC_OPTIONS.

SupportedPacketFilters

Флаги фильтра пакетов для мини-адаптера.

MaxMulticastListSize

Размер списка адресов многоадресной рассылки для мини-адаптера. Дополнительные сведения см. в разделе OID_802_3_MAXIMUM_LIST_SIZE.

MacAddressLength

Длина MAC-адреса в байтах. Длина MAC-адреса зависит от типа носителя.

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Постоянный MAC-адрес. For example, the OID_802_3_PERMANENT_ADDRESS OID specifies the permanent MAC address for IEEE 802.3 drivers.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Текущий MAC-адрес. For example, the OID_802_3_CURRENT_ADDRESS OID specifies the current MAC address for IEEE 802.3 drivers.

RecvScaleCapabilities

Возможности масштабирования на стороне получения (RSS) сетевого адаптера. If the miniport adapter does not support the RSS feature, set RecvScaleCapabilities to NULL. Дополнительные сведения о RSS см. в разделе OID_GEN_RECEIVE_SCALE_CAPABILITIES.

AccessType

A NET_IF_ACCESS_TYPE NDIS network interface access type.

DirectionType

A NET_IF_DIRECTION_TYPE NDIS network interface direction type.

ConnectionType

A NET_IF_CONNECTION_TYPE NDIS network interface connection type.

IfType

Тип интерфейса центра назначения номеров Интернета (IANA). For example, IF_TYPE_ETHERNET_CSMACD (6) is the value for IfType that is assigned to any Ethernet-like interface. Список типов интерфейсов см. в разделе "Типы интерфейсов NDIS".

IfConnectorPresent

Логическое значение, указывающее, присутствует ли соединитель. Set this value to TRUE if there is a physical adapter.

SupportedStatistics

Поддерживаемая статистика.

Note NDIS 6.0 drivers must support all statistics and must report them when the drivers are queried for OID_GEN_STATISTICS.
 
Значением является побитовое ИЛИ следующих флагов:

NDIS_STATISTICS_DIRECTED_FRAMES_RCV_SUPPORTED

The data in the ifHCInUcastPkts member is valid.

NDIS_STATISTICS_MULTICAST_FRAMES_RCV_SUPPORTED

The data in the ifHCInMulticastPkts member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_BROADCAST_FRAMES_RCV_SUPPORTED

The data in the ifHCInBroadcastPkts member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_BYTES_RCV_SUPPORTED

The data in the ifHCInOctets member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_RCV_DISCARDS_SUPPORTED

The data in the ifInDiscards member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_RCV_ERROR_SUPPORTED

The data in the ifInErrors member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_DIRECTED_FRAMES_XMIT_SUPPORTED

The data in the ifHCOutUcastPkts member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_MULTICAST_FRAMES_XMIT_SUPPORTED

The data in the ifHCOutMulticastPkts member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_BROADCAST_FRAMES_XMIT_SUPPORTED

The data in the ifHCOutBroadcastPkts member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_BYTES_XMIT_SUPPORTED

The data in the ifHCOutOctets member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_XMIT_ERROR_SUPPORTED

The data in the ifOutErrors member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_XMIT_DISCARDS_SUPPORTED

The data in the ifOutDiscards member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_DIRECTED_BYTES_RCV_SUPPORTED

The data in the ifHCInUcastOctets member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_MULTICAST_BYTES_RCV_SUPPORTED

The data in the ifHCInMulticastOctets member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_BROADCAST_BYTES_RCV_SUPPORTED

The data in the ifHCInBroadcastOctets member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_DIRECTED_BYTES_XMIT_SUPPORTED

The data in the ifHCOutUcastOctets member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_MULTICAST_BYTES_XMIT_SUPPORTED

The data in the ifHCOutMulticastOctets member of NDIS_STATISTICS_INFO is valid.

NDIS_STATISTICS_BROADCAST_BYTES_XMIT_SUPPORTED

The data in the ifHCOutBroadcastOctets member of NDIS_STATISTICS_INFO is valid.

SupportedPauseFunctions

Поддержка кадров приостановки IEEE 802.3 в качестве одной из следующих функций приостановки:

NdisPauseFunctionsUnsupported

Указывает, что партнер адаптера или канала не поддерживает приостановку кадров.

NdisPauseFunctionsSendOnly

Указывает, что адаптер и партнер связи поддерживают только отправку кадров приостановки из адаптера в партнер связи.

NdisPauseFunctionsReceiveOnly

Указывает, что адаптер и партнер связи поддерживают только отправку кадров приостановки с партнера связи на адаптер.

NdisPauseFunctionsSendAndReceive

Указывает, что адаптер и партнер связи поддерживают отправку и получение кадров приостановки как в трансинте, так и в направлениях получения.

NdisPauseFunctionsUnknown

Указывает, что выполняется согласование кадров приостановки. Поддержка кадра приостановки, которую предоставляет партнер ссылки, неизвестен.

DataBackFillSize

Требуемый размер резервной заполнения данных в байтах драйвера.

ContextBackFillSize

Требуемый размер резервной заполнения контекста в байтах драйвера.

SupportedOidList

Список OID, поддерживаемых драйвером мини-порта. For more information, see OID_GEN_SUPPORTED_LIST.

SupportedOidListLength

The size, in bytes, of the OID list at SupportedOidList .

AutoNegotiationFlags

Параметры автоматического согласования для мини-адаптера. Этот элемент создается побитовой или из следующих флагов:

Адаптер автоматически согласовывает скорость передачи с партнером связи.

Адаптер автоматически согласовывает скорость передачи с партнером связи.

Адаптер автоматически согласовывает дуплексное состояние с партнером связи.

Адаптер автоматически согласовывает функции приостановки с партнером связи.

PowerManagementCapabilitiesEx

A pointer to an NDIS_PM_CAPABILITIES structure. Эта структура задает возможности управления питанием мини-адаптера. Этот член является обязательным для драйверов NDIS 6.20 и более поздних версий.

Remarks

A miniport driver passes a pointer to an NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES structure in the MiniportAttributes parameter of the NdisMSetMiniportAttributes function. A miniport driver calls NdisMSetMiniportAttributes from its MiniportInitializeEx function during initialization. Драйверы минипорта должны задавать эти атрибуты после задания атрибутов регистрации в NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES structure and before they set any other attributes. Установка этого атрибута является обязательным.

Requirements

Requirement Value
Минимальный поддерживаемый клиент Поддерживается в NDIS 6.0 и более поздних версиях.
Header miniportgeneralattributes.h (include ndis.h)

See also

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

  • Last updated on