структура NDIS_LINK_STATE (ntddndis.h)

Статья
08/07/2023

Структура NDIS_LINK_STATE указывает текущее состояние связи адаптера мини-порта.

Синтаксис

typedef struct _NDIS_LINK_STATE {
  NDIS_OBJECT_HEADER             Header;
  NDIS_MEDIA_CONNECT_STATE       MediaConnectState;
  NDIS_MEDIA_DUPLEX_STATE        MediaDuplexState;
  ULONG64                        XmitLinkSpeed;
  ULONG64                        RcvLinkSpeed;
  NDIS_SUPPORTED_PAUSE_FUNCTIONS PauseFunctions;
  ULONG                          AutoNegotiationFlags;
} NDIS_LINK_STATE, *PNDIS_LINK_STATE;

Члены

Header

Структура NDIS_OBJECT_HEADER для структуры NDIS_LINK_STATE . Задайте для элемента Type структуры, указанной в заголовке , значение NDIS_OBJECT_TYPE_DEFAULT, для элемента Revision — NDIS_LINK_STATE_REVISION_1, а для элемента Size — значение NDIS_SIZEOF_LINK_STATE_REVISION_1.

MediaConnectState

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

MediaDuplexState

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

XmitLinkSpeed

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

Примечание Значение NDIS_LINK_SPEED_UNKNOWN указывает, что скорость передачи канала неизвестна.

RcvLinkSpeed

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

Примечание Значение NDIS_LINK_SPEED_UNKNOWN указывает, что скорость канала получения неизвестна.

PauseFunctions

Тип поддержки приостановки кадров IEEE 802.3. Этот элемент должен быть одной из следующих функций приостановки:

NdisPauseFunctionsUnsupported

Адаптер мини-порта или партнер по компоновке не поддерживает кадры приостановки.

NdisPauseFunctionsSendOnly

Адаптер мини-порта и партнер по компоновке поддерживают только отправку фреймов приостановки из адаптера мини-порта партнеру по каналу.

NdisPauseFunctionsReceiveOnly

адаптер мини-порта и партнер по компоновке поддерживают только отправку кадров приостановки от партнера по каналу адаптеру мини-порта

NdisPauseFunctionsSendAndReceive

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

NdisPauseFunctionsUnknown

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

AutoNegotiationFlags

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

NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED

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

NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED

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

NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED

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

NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED

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

Драйверы минипорта используют NDIS_STATUS_LINK_STATE индикатор состояния, чтобы уведомить NDIS и чрезмерно водителей о том, что произошли изменения в физических характеристиках среды.

При создании этого индикатора состояния драйвер задает элемент StatusBuffer структуры NDIS_STATUS_INDICATION указатель на NDIS_LINK_STATE структуру.

Драйвер мини-порта также возвращает структуру NDIS_LINK_STATE при обработке запроса OID OID_GEN_LINK_STATE.

Требования

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