структура 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
Зарезервировано для системного использования.
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) |