OID_GEN_LINK_PARAMETERS
В качестве набора драйверы NDIS и overlying используют OID OID_GEN_LINK_PARAMETERS для задания текущего состояния канала адаптера мини-порта. Драйвер мини-порта получает дуплексное состояние, скорость соединения и функции приостановки в NDIS_LINK_PARAMETERS структуре.
Сведения о версии
Windows Vista и более поздние версии Windows
Поддерживается.
Драйверы мини-портов NDIS 6.0 и более поздних версий
Необязательный элемент.
Структура NDIS_LINK_PARAMETERS определяется следующим образом:
typedef struct _NDIS_LINK_PARAMETERS {
NDIS_OBJECT_HEADER Header;
NDIS_MEDIA_DUPLEX_STATE MediaDuplexState;
ULONG64 XmitLinkSpeed;
ULONG64 RcvLinkSpeed;
NDIS_SUPPORTED_PAUSE_FUNCTIONS PauseFunctions;
ULONG AutoNegotiationFlags;
} NDIS_LINK_PARAMETERS, *PNDIS_LINK_PARAMETERS;
Эта структура содержит следующие элементы:
Заголовка
Структура NDIS_OBJECT_HEADER для структуры NDIS_LINK_PARAMETERS. Задайте для элемента Type структуры, указанной заголовком , значение NDIS_OBJECT_TYPE_DEFAULT, для элемента Revision — NDIS_LINK_PARAMETERS_REVISION_1, а для элемента Size — значение NDIS_SIZEOF_LINK_PARAMETERS_REVISION_1.
MediaDuplexState
Дуплексное состояние мультимедиа. Это значение совпадает со значением, возвращаемым OID_GEN_MEDIA_DUPLEX_STATE OID.
XmitLinkSpeed
Скорость передачи канала в битах в секунду.
RcvLinkSpeed
Скорость канала получения в битах в секунду.
PauseFunctions
Тип поддержки приостановки кадров IEEE 802.3. Этот элемент должен быть одной из следующих функций приостановки:
NdisPauseFunctionsUnsupported
Адаптер или партнер по компоновке не поддерживают кадры приостановки.
NdisPauseFunctionsSendOnly
Адаптер и партнер связи поддерживают только отправку фреймов приостановки из адаптера партнеру по каналу.
NdisPauseFunctionsReceiveOnly
Адаптер и партнер связи поддерживают только отправку фреймов приостановки от партнера по каналу адаптеру.
NdisPauseFunctionsSendAndReceive
Адаптер и партнер по компоновке поддерживают отправку и получение кадров приостановки в направлениях передачи и получения.
AutoNegotiationFlags
Параметры автоматического согласования для адаптера мини-порта. Этот элемент создается на основе побитового ИЛИ следующих флагов:
NDIS_LINK_STATE_XMIT_LINK_SPEED_AUTO_NEGOTIATED
Адаптер должен автоматически согласовывать скорость передачи канала с партнером по каналу. Если этот флаг не установлен, драйвер мини-порта должен задать для скорости канала передачи значение, указанное в элементе XmitLinkSpeed .
NDIS_LINK_STATE_RCV_LINK_SPEED_AUTO_NEGOTIATED
Адаптер должен автоматически согласовывать скорость получения канала с партнером по каналу. Если этот флаг не установлен, драйвер мини-порта должен задать для скорости канала получения значение, указанное в элементе RcvLinkSpeed .
NDIS_LINK_STATE_DUPLEX_AUTO_NEGOTIATED
Адаптер должен автоматически согласовывать дуплексное состояние с партнером по каналу. Если этот флаг не установлен, драйвер мини-порта должен задать для дуплексного состояния значение, указанное в элементе MediaDuplexState .
NDIS_LINK_STATE_PAUSE_FUNCTIONS_AUTO_NEGOTIATED
Драйвер мини-порта должен автоматически согласовывать поддержку фреймов приостановки с другим концом. Если этот флаг не установлен, драйвер мини-порта должен использовать поддержку кадра приостановки, указанную в элементе PauseFunctions .
Комментарии
Примечание Настройка OID_GEN_LINK_PARAMETERS может привести к потере подключения. При установке этого идентификатора OID драйверы мини-порта должны перенастроить адаптер мини-порта. Например, драйвер мини-порта может сбросить адаптер мини-порта с потерей существующих подключений. Конкретный механизм перенастройки зависит от приложения.
Если состояние связи адаптера мини-порта меняется из-за запроса на настройку OID_GEN_LINK_PARAMETERS, драйвер мини-порта должен создать NDIS_STATUS_LINK_STATE индикатор состояния, чтобы уведомить NDIS и драйверы о новом состоянии связи.
Требования
Заголовок |
Ntddndis.h (включая Ndis.h) |