Share via

OID_PNP_ENABLE_WAKE_UP

  • Статья

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

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

Элемент InformationBuffer структуры NDIS_OID_REQUEST представляет собой битовую маску флагов, которую можно использовать для включения сочетания событий пробуждения:

NDIS_PNP_WAKE_UP_MAGIC_PACKET
Если задано значение , указывает, что драйвер мини-порта должен разрешить сетевому адаптеру сигнализировать о событии пробуждения при получении магического пакета. ( Магический пакет — это пакет, содержащий 16 смежных копий ethernet-адреса принимающего сетевого адаптера.) При снятии указывает, что драйвер мини-порта должен отключить сигнал сетевого адаптера о таком событии пробуждения.

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

NDIS_PNP_WAKE_UP_LINK_CHANGE
Зарезервировано. NDIS игнорирует этот флаг.

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

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

Перед переходом сетевого адаптера в состояние с низким энергопотреблением (то есть до того, как NDIS отправит драйверу минипорта запрос OID_PNP_SET_POWER ), NDIS отправляет драйверу минипорта OID_PNP_ENABLE_WAKE_UP запрос на включение соответствующих возможностей пробуждения.

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

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

Промежуточный драйвер, в котором верхний край получает этот запрос OID, должен всегда распространять запрос на базовый драйвер miniport путем вызова функции NdisOidRequest или NdisCoOidRequest .

Требования

Версия

Поддерживается в NDIS 6.0 и 6.1. Для NDIS 6.20 и более поздних версий используйте вместо него OID_PM_PARAMETERS ).

Заголовок

 Ntddndis.h (включая Ndis.h)

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

NDIS_BIND_PARAMETERS

NDIS_OID_REQUEST

NdisCoOidRequest

NdisOidRequest

OID_PM_PARAMETERS

OID_PNP_ADD_WAKE_UP_PATTERN