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

  • Статья

Драйвер минипорта NDIS настраивает структуру NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES для определения общих атрибутов драйвера мини-порта, связанных с адаптером мини-порта.

Синтаксис

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;

Члены

Header

Структура NDIS_OBJECT_HEADER для структуры NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES . Присвойте элементу Type структуры, заданной заголовком, NDIS_OBJECT_TYPE_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES.

Чтобы указать версию структуры NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES , задайте для элемента Revision одно из следующих значений:

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2

Добавлен элемент PowerManagementCapabilitiesEx для NDIS 6.2.

Задайте для элемента Размерзначение NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_2.

NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1

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

Задайте для элемента Размерзначение NDIS_SIZEOF_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES_REVISION_1.

Flags

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

MediaType

Тип NdisMediumXxx , поддерживаемый адаптером мини-порта. Дополнительные сведения см. в разделе NDIS_MEDIUM.

PhysicalMediumType

Тип физического носителя для адаптера мини-порта. Дополнительные сведения см. в разделе OID_GEN_PHYSICAL_MEDIUM

MtuSize

Максимальный размер единицы передачи (MTU). Дополнительные сведения см. в разделе OID_GEN_MAXIMUM_FRAME_SIZE.

MaxXmitLinkSpeed

Максимальная скорость канала передачи адаптера в битах в секунду. Дополнительные сведения см. в разделе OID_GEN_MAX_LINK_SPEED.

XmitLinkSpeed

Текущая скорость канала передачи адаптера в битах в секунду. Дополнительные сведения см. в разделе OID_GEN_LINK_SPEED_EX.

MaxRcvLinkSpeed

Максимальная скорость канала приема адаптера в битах в секунду. Дополнительные сведения см. в разделе OID_GEN_MAX_LINK_SPEED.

RcvLinkSpeed

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

MediaConnectState

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

MediaDuplexState

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

LookaheadSize

Размер lookahead для адаптера мини-порта. Дополнительные сведения см. в разделе OID_GEN_CURRENT_LOOKAHEAD.

PowerManagementCapabilities

Возможности адаптера мини-порта Plug and Play (PnP). Дополнительные сведения о возможностях PnP см. в разделе OID_PNP_CAPABILITIES. Если адаптер минипорта не поддерживает управление питанием, драйвер минипорта должен задать для PowerManagementCapabilitiesзначение NULL. Драйверы NDIS 6.20 и более поздних версий должны использовать элемент PowerManagementCapabilitiesEx .

MacOptions

Параметры MAC-адреса для адаптера мини-порта. Дополнительные сведения см. в разделе OID_GEN_MAC_OPTIONS.

SupportedPacketFilters

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

MaxMulticastListSize

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

MacAddressLength

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

PermanentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Постоянный MAC-адрес. Например, OID_802_3_PERMANENT_ADDRESS OID указывает постоянный MAC-адрес для драйверов IEEE 802.3.

CurrentMacAddress[NDIS_MAX_PHYS_ADDRESS_LENGTH]

Текущий MAC-адрес. Например, OID_802_3_CURRENT_ADDRESS OID указывает текущий MAC-адрес для драйверов IEEE 802.3.

RecvScaleCapabilities

Возможности масштабирования на стороне приема (RSS) сетевого адаптера. Если адаптер мини-порта не поддерживает функцию RSS, задайте для RecvScaleCapabilities значение NULL. Дополнительные сведения о RSS см. в разделе OID_GEN_RECEIVE_SCALE_CAPABILITIES.

AccessType

Тип доступа к сетевому интерфейсу NET_IF_ACCESS_TYPE NDIS.

DirectionType

Тип направления сетевого интерфейса NET_IF_DIRECTION_TYPE NDIS.

ConnectionType

Тип подключения сетевого интерфейса NET_IF_CONNECTION_TYPE NDIS.

IfType

Тип интерфейса IANA. Например, IF_TYPE_ETHERNET_CSMACD (6) — это значение ifType , назначенное любому интерфейсу, подобному Ethernet. Список типов интерфейсов см. в разделе Типы интерфейсов NDIS.

IfConnectorPresent

Логическое значение, указывающее, присутствует ли соединитель. При наличии физического адаптера задайте для этого значения значение TRUE .

SupportedStatistics

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

Примечание Драйверы NDIS 6.0 должны поддерживать всю статистику и сообщать о них при запросе OID_GEN_STATISTICS.
 
Значением является побитовое ИЛИ следующих флагов:

NDIS_STATISTICS_DIRECTED_FRAMES_RCV_SUPPORTED

Данные в элементе ifHCInUcastPkts являются допустимыми .

NDIS_STATISTICS_MULTICAST_FRAMES_RCV_SUPPORTED

Данные в элементе ifHCInMulticastPkts NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_BROADCAST_FRAMES_RCV_SUPPORTED

Данные в элементе ifHCInBroadcastPkts NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_BYTES_RCV_SUPPORTED

Данные в элементе ifHCInOctets NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_RCV_DISCARDS_SUPPORTED

Данные в элементе ifInDiscards NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_RCV_ERROR_SUPPORTED

Допустимы данные в элементе ifInErrors NDIS_STATISTICS_INFO.

NDIS_STATISTICS_DIRECTED_FRAMES_XMIT_SUPPORTED

Данные в элементе ifHCOutUcastPkts NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_MULTICAST_FRAMES_XMIT_SUPPORTED

Данные в элементе ifHCOutMulticastPkts NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_BROADCAST_FRAMES_XMIT_SUPPORTED

Данные в элементе ifHCOutBroadcastPkts NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_BYTES_XMIT_SUPPORTED

Данные в элементе ifHCOutOctets NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_XMIT_ERROR_SUPPORTED

Данные в элементе ifOutErrors NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_XMIT_DISCARDS_SUPPORTED

Данные в элементе ifOutDiscards NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_DIRECTED_BYTES_RCV_SUPPORTED

Данные в элементе ifHCInUcastOctets NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_MULTICAST_BYTES_RCV_SUPPORTED

Данные в элементе ifHCInMulticastOctets NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_BROADCAST_BYTES_RCV_SUPPORTED

Данные в элементе ifHCInBroadcastOctets NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_DIRECTED_BYTES_XMIT_SUPPORTED

Данные в элементе ifHCOutUcastOctets NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_MULTICAST_BYTES_XMIT_SUPPORTED

Данные в элементе ifHCOutMulticastOctets NDIS_STATISTICS_INFO являются допустимыми.

NDIS_STATISTICS_BROADCAST_BYTES_XMIT_SUPPORTED

Данные в элементе ifHCOutBroadcastOctets NDIS_STATISTICS_INFO являются допустимыми.

SupportedPauseFunctions

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

NdisPauseFunctionsUnsupported

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

NdisPauseFunctionsSendOnly

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

NdisPauseFunctionsReceiveOnly

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

NdisPauseFunctionsSendAndReceive

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

NdisPauseFunctionsUnknown

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

DataBackFillSize

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

ContextBackFillSize

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

SupportedOidList

Список идентификаторов OID, поддерживаемых драйвером мини-порта. Дополнительные сведения см. в разделе OID_GEN_SUPPORTED_LIST.

SupportedOidListLength

Размер списка OID в байтах в SupportedOidList .

AutoNegotiationFlags

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

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

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

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

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

PowerManagementCapabilitiesEx

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

Комментарии

Драйвер мини-порта передает указатель на структуру NDIS_MINIPORT_ADAPTER_GENERAL_ATTRIBUTES в параметре MiniportAttributes объекта Функция NdisMSetMiniportAttributes . Драйвер мини-порта вызывает NdisMSetMiniportAttributes из функции MiniportInitializeEx во время инициализации. Драйверы мини-порта должны задавать эти атрибуты после установки атрибутов регистрации в NDIS_MINIPORT_ADAPTER_REGISTRATION_ATTRIBUTES структуру и до установки других атрибутов. Установка этих атрибутов является обязательной.

Требования

Требование Значение
Минимальная версия клиента Поддерживается в NDIS 6.0 и более поздних версиях.
Верхняя часть ndis.h (включая Ndis.h)

См. также раздел

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