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

OID_PM_WOL_PATTERN_LIST

  • Статья

В качестве запроса слишком многомерные драйверы могут использовать OID OID_PM_WOL_PATTERN_LIST для перечисления шаблонов пробуждения по локальной сети, заданных на базовом сетевом адаптере. После успешного возврата из запроса элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на список NDIS_PM_WOL_PATTERN структур, описывающих добавленные в настоящее время шаблоны WOL.

Комментарии

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

Для каждой структуры NDIS_PM_WOL_PATTERN в списке NDIS задает для элемента NextWoLPatternOffset смещение от начала буфера сведений об идентификаторе (т. е. начала буфера, на который указывает элемент InformationBuffer структуры NDIS_OID_REQUEST ) до начала следующей NDIS_PM_WOL_PATTERN структуры в списке. Смещение в элементе NextWoLPatternOffset последней структуры в списке равно нулю.

Для смещения в структуре NDIS_PM_WOL_PATTERN , отличной от NextWoLPatternOffset (например, NameBufferOffset), NDIS предоставляет смещения относительно начала каждой NDIS_PM_WOL_PATTERN структуры.

Если на сетевом адаптере не заданы шаблоны WOL, NDIS задает data. QUERY_INFORMATION. Элемент BytesWrittenструктуры NDIS_OID_REQUEST нулевой и возвращает NDIS_STATUS_SUCCESS для запроса. Данные в data. QUERY_INFORMATION. Элемент InformationBuffer не изменяется NDIS.

NDIS возвращает один из следующих кодов состояния для запроса:

NDIS_STATUS_SUCCESS
Запрос успешно выполнен. InformationBuffer содержит указатель на список шаблонов WOL, если таковые есть.

NDIS_STATUS_PENDING
Запрос ожидает завершения. Окончательный код состояния и результаты будут переданы обработчику завершения запроса OID вызывающего объекта.

NDIS_STATUS_BUFFER_TOO_SHORT
Буфер сведений был слишком коротким. NDIS задает data. QUERY_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера.

NDIS_STATUS_FAILURE
Запрос завершился сбоем по причинам, отличным от предыдущих.

Требования

Версия

Поддерживается в NDIS 6.20 и более поздних версиях. Не запрашивается для драйверов мини-порта. (См. раздел примeчаний).

Заголовок

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

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

NDIS_OID_REQUEST

NDIS_PM_WOL_PATTERN

OID_PM_ADD_WOL_PATTERN

OID_PM_REMOVE_WOL_PATTERN

OID_PNP_WAKE_UP_PATTERN_LIST