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


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

Структура NDIS_PORT_CHARACTERISTICS определяет характеристики порта NDIS. Дополнительные сведения о портах NDIS см. в разделе Порты NDIS.

Синтаксис

typedef struct _NDIS_PORT_CHARACTERISTICS {
  NDIS_OBJECT_HEADER            Header;
  NDIS_PORT_NUMBER              PortNumber;
  ULONG                         Flags;
  NDIS_PORT_TYPE                Type;
  NDIS_MEDIA_CONNECT_STATE      MediaConnectState;
  ULONG64                       XmitLinkSpeed;
  ULONG64                       RcvLinkSpeed;
  NET_IF_DIRECTION_TYPE         Direction;
  NDIS_PORT_CONTROL_STATE       SendControlState;
  NDIS_PORT_CONTROL_STATE       RcvControlState;
  NDIS_PORT_AUTHORIZATION_STATE SendAuthorizationState;
  NDIS_PORT_AUTHORIZATION_STATE RcvAuthorizationState;
} NDIS_PORT_CHARACTERISTICS, *PNDIS_PORT_CHARACTERISTICS;

Члены

Header

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

PortNumber

Номер порта NDIS, связанного с этой структурой NDIS_PORT_CHARACTERISTICS . Значение PortNumber — это значение NDIS_PORT_NUMBER, которое имеет тип данных ULONG и допустимо от нуля до 0xffffff, где нуль зарезервирован для порта по умолчанию.

Flags

Побитовое или сочетание флагов характеристик порта или ноль, если флаги не заданы. В настоящее время существует один флаг.

Если установлен флаг NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS, NDIS игнорирует параметры состояния проверки подлинности и использует состояние проверки подлинности по умолчанию. Драйвер мини-порта может использовать этот флаг для запроса использования NDIS параметров состояния проверки подлинности по умолчанию для портов, которые он выделяет и активирует. Если драйвер мини-порта управляет портом по умолчанию, когда драйвер мини-порта активирует порт по умолчанию, драйвер может задать NDIS_PORT_CHAR_USE_DEFAULT_AUTH_SETTINGS для активации порта по умолчанию с параметрами состояния проверки подлинности по умолчанию.

Type

Тип порта NDIS. Дополнительные сведения см. в разделе Типы портов NDIS. Этот тип может иметь одно из следующих значений.

NdisPortTypeUndefined

Тип порта по умолчанию.

NdisPortTypeBridge

Зарезервировано для системного использования.

NdisPortTypeRasConnection

Подключение к службе удаленного доступа (RAS).

NdisPortType8021xSupplicant

Удаленная беспроводная станция, связанная с точкой доступа на этом хост-компьютере.

NdisPortTypeNdisImPlatform

Зарезервировано для системного использования.

Примечание Это значение поддерживается только в NDIS 6.30 и более поздних версиях.
 

MediaConnectState

Состояние подключения к мультимедиа порта. Это состояние является той же информацией, что и OID_GEN_MEDIA_CONNECT_STATUS_EX Возвращает OID.

XmitLinkSpeed

Скорость передачи канала порта в битах в секунду. Значение -1 в этом элементе указывает, что скорость передачи канала неизвестна.

RcvLinkSpeed

Скорость канала получения порта в битах в секунду. Значение -1 в этом элементе указывает, что скорость канала получения неизвестна.

Direction

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

SendControlState

Состояние управления порта для операций отправки. Этот элемент должен содержать одно из следующих значений:

NdisPortControlStateUnknown

Состояние управления порта для операций отправки неизвестно.

NdisPortControlStateControlled

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

NdisPortControlStateUncontrolled

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

RcvControlState

Состояние управления порта для операций получения. Этот элемент должен содержать одно из следующих значений:

NdisPortControlStateUnknown

Состояние управления порта для операций получения неизвестно.

NdisPortControlStateControlled

Порт находится в управляемом состоянии для операций получения (то есть порт требует авторизации), а значение в элементе SendAuthorizationState определяет состояние проверки подлинности.

NdisPortControlStateUncontrolled

Порт находится в неконтролируемом состоянии для операций получения. Поэтому проверка подлинности не применяется к этому порту.

SendAuthorizationState

Состояние авторизации порта для операций отправки. Игнорируйте этот элемент, если для элемента SendControlState задано значение NdisPortControlStateUncontrolled.

SendAuthorizationState должно содержать одно из следующих значений:

NdisPortAuthorizationUnknown

Состояние авторизации порта для операций отправки неизвестно.

NdisPortAuthorized

Порт авторизован для операций отправки.

NdisPortUnauthorized

Порт не авторизован для операций отправки.

NdisPortReauthorizing

Порт повторно авторизуется для операций отправки.

RcvAuthorizationState

Состояние авторизации порта для операций получения. Игнорируйте этот элемент, если для элемента RcvControlState задано значение NdisPortControlStateUncontrolled.

RcvAuthorizationState должно содержать одно из следующих значений:

NdisPortAuthorizationUnknown

Состояние авторизации порта для операций получения неизвестно.

NdisPortAuthorized

Порт авторизован для операций получения.

NdisPortUnauthorized

Порт не авторизован для операций получения.

NdisPortReauthorizing

Порт повторно авторизуется для операций получения.

Комментарии

Структура NDIS_PORT_CHARACTERISTICS определяет характеристики порта NDIS. Эта структура отображается в списке характеристик портов, указанных в структуре NDIS_PORT_ARRAY , используемой с OID OID_GEN_ENUMERATE_PORTS .

Чтобы выделить порт NDIS, драйвер инициализирует структуру NDIS_PORT_CHARACTERISTICS и передает ее функции NdisMAllocatePort . Когда NdisMAllocatePort успешно возвращается, NDIS задает член PortNumberNDIS_PORT_CHARACTERISTICS номер порта, назначенный NDIS порту.

NDIS использует связанный список портов в событиях активации портов Plug and Play (PnP). NDIS использует структуру NDIS_PORT для создания связанного списка портов, а каждая структура NDIS_PORT содержит NDIS_PORT_CHARACTERISTICS структуру.

Требования

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

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

Порты NDIS

NDIS_OBJECT_HEADER

NDIS_PORT

NDIS_PORT_ARRAY

NET_IF_DIRECTION_TYPE

NdisMAllocatePort

OID_GEN_ENUMERATE_PORTS

OID_GEN_MEDIA_CONNECT_STATUS_EX

Типы портов NDIS