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) |