OID_PNP_ADD_WAKE_UP_PATTERN
OID OID_PNP_ADD_WAKE_UP_PATTERN отправляется драйвером протокола в драйвер мини-порта для указания шаблона пробуждения. Шаблон пробуждения вместе с маской описывается структурой NDIS_PM_PACKET_PATTERN .
Протокол, обеспечивающий пробуждение по шаблону для драйвера минипорта (см . OID_PNP_ENABLE_WAKE_UP), использует OID_PNP_ADD_WAKE_UP_PATTERN для указания шаблона пробуждения. Шаблон пробуждения может храниться в памяти узла или на сетевом адаптере в зависимости от возможностей сетевого адаптера.
Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит следующее:
Структура NDIS_PM_PACKET_PATTERN , которая предоставляет сведения о шаблоне и его маске.
Маска, указывающая, какие байты входящего пакета следует сравнивать с соответствующими байтами в шаблоне. Маска начинается с первого байта пакета. Маска сразу же следует за структурой NDIS_PM_PACKET_PATTERN в InformationBuffer. Дополнительные сведения о том, как работает эта маска, см. в справочнике по управлению питанием класса сетевых устройств.
Шаблон пробуждения, начинающий байты PatternOffset с начала InformationBuffer. Дополнительные сведения о шаблонах пробуждения см. в справочнике по управлению питанием класса сетевых устройств.
Количество шаблонов пробуждения, которые драйвер мини-порта может принимать из протокола, может зависеть от доступности ресурсов, таких как память узла, выделенная драйвером мини-порта для таких шаблонов, или доступного хранилища в сетевом адаптере. Если драйвер мини-порта не может добавить шаблон пробуждения из-за нехватки ресурсов, драйвер минипорта возвращает NDIS_STATUS_RESOURCES в ответ на OID_PNP_ADD_WAKE_UP_PATTERN.
Если драйвер протокола пытается добавить повторяющийся шаблон, драйвер минипорта должен вернуть NDIS_STATUS_INVALID_DATA в ответ на OID_PNP_ADD_WAKE_UP_PATTERN.
Промежуточный драйвер, в котором верхний край получает этот запрос OID, должен всегда распространять запрос на базовый драйвер miniport, вызывая NdisRequest или NdisCoRequest.
Требования
Версия |
Поддерживается в NDIS 6.0 и NDIS 6.1. Для NDIS 6.20 и более поздних версий используйте вместо него OID_PM_ADD_WOL_PATTERN . |
Заголовок |
Ntddndis.h (включая Ndis.h) |