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

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

  • Статья

Структура NDIS_PM_PARAMETERS указывает текущие или новые аппаратные возможности управления питанием, которые включены для сетевого адаптера.

Синтаксис

typedef struct _NDIS_PM_PARAMETERS {
  NDIS_OBJECT_HEADER Header;
  ULONG              EnabledWoLPacketPatterns;
  ULONG              EnabledProtocolOffloads;
  ULONG              WakeUpFlags;
  ULONG              MediaSpecificWakeUpEvents;
} NDIS_PM_PARAMETERS, *PNDIS_PM_PARAMETERS;

Члены

Header

Тип, редакция и размер структуры NDIS_PM_PARAMETERS . Этот элемент отформатирован как структура NDIS_OBJECT_HEADER .

Драйвер мини-порта должен задать для элемента Typeзаголовка значение NDIS_OBJECT_TYPE_DEFAULT. Чтобы указать версию структуры NDIS_PM_PARAMETERS , драйвер должен задать для элемента Revisionзаголовка следующее значение:

NDIS_PM_PARAMETERS_REVISION_2

Добавлены различные изменения для NDIS 6.30.

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

NDIS_PM_PARAMETERS_REVISION_1

Исходная версия для NDIS 6.20.

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

EnabledWoLPacketPatterns

Значение ULONG , содержащее побитовое ИЛИ флагов, соответствующих возможностям, которые драйвер минипорта сообщил в элементе SupportedWoLPacketPatterns структуры NDIS_PM_CAPABILITIES . NDIS использует эти флаги для включения шаблонов пробуждения по локальной сети (WOL), которые сетевой адаптер использует для пробуждения локального компьютера из состояния низкого энергопотребления. Дополнительные сведения о шаблонах WOL см. в разделе NDIS_PM_WOL_PATTERN.

Используются следующие флаги:

NDIS_PM_WOL_BITMAP_PATTERN_ENABLED

Если этот флаг установлен, сетевому адаптеру разрешено создавать событие пробуждения при получении пакета, соответствующего настроенной схеме растрового изображения.

NDIS_PM_WOL_MAGIC_PACKET_ENABLED

Если этот флаг установлен, сетевой адаптер может создавать событие пробуждения при получении магического пакета WOL. Магический пакет содержит в своих полезных данных строку из шести байтов со значением 0xFF, а затем сразу 16 смежных копий MAC-адреса принимающего сетевого адаптера.

NDIS_PM_WOL_EAPOL_REQUEST_ID_MESSAGE_ENABLED

Если этот флаг установлен, сетевой адаптер может создавать событие пробуждения при получении сообщения идентификатора запроса EAPOL.

NDIS_PM_WOL_IPV4_TCP_SYN_ENABLED

Если этот флаг установлен, сетевой адаптер может создавать событие пробуждения при получении пакета SYN IPv4 TCP. Удаленные узлы отправляют пакеты TCP SYN для инициации TCP-подключения к локальному компьютеру.

NDIS_PM_WOL_IPV6_TCP_SYN_ENABLED

Если этот флаг установлен, сетевой адаптер может создавать событие пробуждения при получении пакета SYN IPv6 TCP.

NDIS_PM_WOL_IPV4_DEST_ADDR_WILDCARD_ENABLED

Если этот флаг установлен, сетевой адаптер должен рассматривать как значения с подстановочными знаками любые значения, заполненные нулевыми или неопределенными, для IPv4-адресов и портов TCP/UDP в шаблоне WOL. Таким образом, значение подстановочного знака соответствует любому IPv4-адресу и любому значению порта входящего пакета в расположении, указанном в шаблоне WOL.

Если этот флаг установлен, сетевой адаптер может создать событие пробуждения, если выполняются следующие условия соответствия шаблону:

  • Любое значение из входящего пакета в расположении, указанном шаблоном WOL, совпадает, если шаблон WOL для этого расположения содержит значение с подстановочными знаками.
  • Значение из входящего пакета в расположении, указанном шаблоном WOL, совпадает, если шаблон WOL для этого расположения содержит ненулевое значение, равное значению пакета.

Примечание

 Значения с подстановочными знаками, включенные этим флагом, могут включать неуказаемые исходные и целевые адреса IPv4, а также не указанные порты источника и назначения.

NDIS_PM_WOL_IPV6_DEST_ADDR_WILDCARD_ENABLED

Если этот флаг установлен, сетевой адаптер должен рассматривать как значения с подстановочными знаками любые значения, заполненные нулевыми или неопределенными, для IPv6-адресов и портов TCP/UDP в шаблоне WOL. Таким образом, значение подстановочного знака соответствует любому IPv6-адресу и любому значению порта входящего пакета в расположении, указанном шаблоном WOL.

Если этот флаг установлен, сетевой адаптер может создать событие пробуждения, если выполняются следующие условия соответствия шаблону:

  • Любое значение из входящего пакета в расположении, указанном шаблоном WOL, совпадает, если шаблон WOL для этого расположения содержит значение с подстановочными знаками.
  • Значение из входящего пакета в расположении, указанном шаблоном WOL, совпадает, если шаблон WOL для этого расположения содержит ненулевое значение, равное значению пакета.

Примечание

 Значения с подстановочными знаками, включенные этим флагом, могут включать неуказаемые исходные и конечные адреса IPv6, а также не указанные порты источника и назначения.

EnabledProtocolOffloads

Значение ULONG , содержащее побитовое ИЛИ флагов, соответствующих возможностям, которые драйвер мини-порта сообщил в элементе SupportedProtocolOffloads структуры NDIS_PM_CAPABILITIES . NDIS использует эти флаги для включения возможностей разгрузки протокола низкого энергопотребления в сетевом адаптере. Используются следующие флаги:

NDIS_PM_PROTOCOL_OFFLOAD_ARP_ENABLED

Если этот бит задан, драйвер overlying будет запрашивать у сетевого адаптера возможность разгрузки протокола ARP. Как только эта разгрузка протокола будет настроена с помощью запроса набора OID_PM_ADD_PROTOCOL_OFFLOAD, драйвер должен разрешить сетевому адаптеру отвечать на пакеты ARP IPv4, пока он находится в маломощном состоянии.

NDIS_PM_PROTOCOL_OFFLOAD_NS_ENABLED

Если этот бит задан, драйвер overlying будет запрашивать у сетевого адаптера возможность разгрузки протокола IPv6 Neighbor Solicitation (NS). Как только эта разгрузка протокола будет настроена с помощью запроса набора OID_PM_ADD_PROTOCOL_OFFLOAD, драйвер должен разрешить сетевому адаптеру реагировать на пакеты NS, пока он находится в маломощном состоянии.

NDIS_PM_PROTOCOL_OFFLOAD_80211_RSN_REKEY_ENABLED

Если этот бит задан, драйвер overlying запрашивает у сетевого адаптера возможность разгрузки протокола IEEE 802.11i Robust Security Network (RSN). Как только эта разгрузка протокола будет настроена с помощью запроса набора OID_PM_ADD_PROTOCOL_OFFLOAD, драйвер должен разрешить сетевому адаптеру отвечать на пакеты повторного ключа RSN, пока он находится в состоянии низкого энергопотребления.

WakeUpFlags

Значение ULONG, содержащее побитовое ИЛИ NDIS_PM_WAKE_ON_ флагов Xxx . NDIS использует эти флаги для включения возможностей пробуждения в сетевом адаптере. Этот член использует следующие флаги:

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

Дополнительные сведения об этой возможности WOL см. в разделе Низкое энергопотребление при отключении мультимедиа.

NDIS_PM_WAKE_ON_MEDIA_DISCONNECT_ENABLED

Если этот флаг установлен, сетевому адаптеру разрешено создавать событие пробуждения при изменении состояния связи с носителя, подключенного к отключенному носителю.

NDIS_PM_SELECTIVE_SUSPEND_ENABLED

Если этот флаг установлен, сетевой адаптер может создавать событие пробуждения при возникновении одного из следующих событий:

  • Сетевой адаптер получает пакет, соответствующий фильтру получаемых пакетов. Адаптер настраивается с помощью этих фильтров с помощью запросов на набор OID OID_GEN_CURRENT_PACKET_FILTER.
  • Сетевой адаптер обнаруживает другие внешние события, требующие обработки стеком сетевых драйверов, например при изменении состояния связи на отключение носителя или подключение носителя.

Примечание

Флаг NDIS_PM_SELECTIVE_SUSPEND_ENABLED доступен в NDIS 6.30 и более поздних версиях.

Если этот флаг установлен, другие флаги управления питанием нельзя задать в элементе WakeUpFlags , а для элемента EnabledWoLPacketPatterns необходимо задать нулевое значение.

Если NDIS задает флаг NDIS_PM_SELECTIVE_SUSPEND_ENABLED , он отправляет запрос на набор OID OID_PM_PARAMETERS непосредственно драйверу мини-порта. Это позволяет NDIS обходить обработку путем фильтрации драйверов в стеке сетевых драйверов.

Дополнительные сведения о возможности управления питанием выборочной приостановки см. в разделе Выборочная приостановка NDIS.

MediaSpecificWakeUpEvents

Значение ULONG , содержащее побитовое ИЛИ флагов. Эти флаги указывают события пробуждения для конкретного носителя, поддерживаемые сетевым адаптером.

Начиная с версии NDIS 6.30, определены следующие флаги:

NDIS_WLAN_WAKE_ON_NLO_DISCOVERY_ENABLED

Если этот флаг установлен, сетевой адаптер 802.11 включается для создания события пробуждения при обнаружении идентификатора набора служб (SSID), указанного с помощью разгрузки сети (NLO).

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

NDIS_WLAN_WAKE_ON_AP_ASSOCIATION_LOST_ENABLED

Если этот флаг установлен, сетевой адаптер 802.11 включен для создания события пробуждения при отмене связи с точкой доступа (AP).

NDIS_WLAN_WAKE_ON_GTK_HANDSHAKE_ERROR_ENABLED

Если этот флаг установлен, сетевой адаптер 802.11 включен для создания события пробуждения при возникновении ошибки во время подтверждения временного ключа ГРУППЫ RSN IEEE 802.11i с AP.

NDIS_WLAN_WAKE_ON_4WAY_HANDSHAKE_REQUEST_ENABLED

Если этот флаг установлен, сетевой адаптер 802.11 включается для создания события пробуждения при получении первого кадра 4-го подтверждения RSN IEEE 802.11i с ap. Это подтверждение выполняется, когда адаптер проходит проверку подлинности с помощью AP.

NDIS_WWAN_WAKE_ON_REGISTER_STATE_ENABLED

Если этот флаг установлен, сетевой адаптер мобильной широкополосной связи (МБ) включается для создания события пробуждения при изменении состояния его регистрации в службе МБ.

NDIS_WWAN_WAKE_ON_SMS_RECEIVE_ENABLED

Если этот флаг установлен, сетевой адаптер МБ включается для создания события пробуждения, когда служба MB должна быть уведомлена о получении sms-сообщения. Адаптер создает это событие пробуждения либо после завершения ранее выданного запроса OID_WWAN_SMS_READ запроса, либо после получения нового сообщения класса 0 (flash/alert) от поставщика сети в качестве уведомления о событии.

NDIS_WWAN_WAKE_ON_USSD_RECEIVE_ENABLED

Если этот флаг установлен, сетевой адаптер MB может создавать событие пробуждения при получении сообщения USSD о неструктурированных дополнительных данных службы ( USSD).

NDIS_WWAN_WAKE_ON_PACKET_STATE_ENABLED

Если этот флаг установлен, сетевой адаптер MB включается для создания события пробуждения при изменении доступности передачи данных пакетов. Этот флаг является новым в Windows 10.

NDIS_WWAN_WAKE_ON_UICC_CHANGE_ENABLED

Если этот флаг установлен, сетевой адаптер MB включен для создания события пробуждения при вставке, удалении или переходе в состояние ошибки карта UICC (SIM). Этот флаг является новым в Windows 10.

Комментарии

Структура NDIS_PM_PARAMETERS определяет включенные аппаратные возможности управления питанием для OID_PM_PARAMETERS OID. При запросе OID_PM_PARAMETERS OID эта структура предоставляет текущую конфигурацию управления питанием. Если задан OID_PM_PARAMETERS OID, эта структура задает новую конфигурацию управления питанием, которую должен использовать сетевой адаптер.

Не следует пытаться включить возможности, которые не поддерживаются сетевым адаптером. Чтобы позволить чрезмерному драйверу определить, какие возможности предоставляет сетевой адаптер, NDIS предоставляет возможности в элементе PowerManagementCapabilitiesEx структуры NDIS_BIND_PARAMETERS .

Примечание

Драйверы NDIS 6.20 и более поздних версий должны использовать элемент PowerManagementCapabilitiesEx структуры NDIS_BIND_PARAMETERS вместо элемента PowerManagementCapabilities .

Требования

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

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

NDIS_BIND_PARAMETERS

NDIS_OBJECT_HEADER

NDIS_PM_CAPABILITIES

NDIS_PM_WOL_PATTERN

OID_GEN_CURRENT_PACKET_FILTER

OID_PM_PARAMETERS