OID_PNP_ENABLE_WAKE_UP
В качестве набора OID_PNP_ENABLE_WAKE_UP OID указывает возможности пробуждения, которые должен включить мини-драйвер в сетевом адаптере.
В качестве запроса 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 задать драйверу минипорта, чтобы включить соответствующие события пробуждения.
Перед переходом сетевого адаптера в состояние низкой мощности (т. е. перед отправкой мини-драйвера минипорта запросом на OID_PNP_SET_POWER), NDIS отправляет мини-порт драйверу OID_PNP_ENABLE_WAKE_UP запрос, чтобы включить соответствующие возможности пробуждения.
Минипорт-драйвер должен выполнить соответствующие действия, зависящие от устройства, чтобы включить или отключить события пробуждения на сетевом адаптере.
Минипорт-драйвер должен очистить возможности пробуждения, установленные NDIS с OID_PNP_ENABLE_WAKE_UP при возобновлении системы. Возможности пробуждения не должны сохраняться в резюме. Если возможности пробуждения включены, NDIS явно устанавливает OID_PNP_ENABLE_WAKE_UP перед переходом мини-порта в состояние низкой мощности.
Промежуточный драйвер, в котором верхний край получает этот запрос OID, должен всегда распространять запрос на базовый драйвер минипорта, вызвав функцию NdisOidRequest или NdisCoOidRequest.
Требования
Версия |
Поддерживается в NDIS 6.0 и 6.1. Для NDIS 6.20 и более поздних версий используйте вместо этого OID_PM_PARAMETERS). |
Заголовок |
Ntddndis.h (include Ndis.h) |