OID_PM_PARAMETERS
В качестве запроса драйверы протокола могут использовать OID OID_PM_PARAMETERS для запроса аппаратных возможностей управления питанием сетевого адаптера, которые в настоящее время включены. После успешного возврата из запроса OID элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_PM_PARAMETERS .
В качестве набора драйверы протоколов могут использовать OID OID_PM_PARAMETERS для включения или отключения текущих аппаратных возможностей сетевого адаптера. Драйвер протокола предоставляет указатель на структуру NDIS_PM_PARAMETERS в элементе InformationBufferструктуры NDIS_OID_REQUEST .
Комментарии
Начиная с версии NDIS 6.20, драйверы протоколов и фильтров используют OID_PM_PARAMETERS для запроса и настройки аппаратных возможностей управления питанием сетевого адаптера, которые в настоящее время включены.
Когда драйвер с превышением запрашивает идентификатор OID OID_PM_PARAMETERS, NDIS завершает запрос, не пересылая его драйверу мини-порта. NDIS сохраняет запрошенные параметры и объединяет их с параметрами из других таких запросов. Прежде чем NDIS переключит сетевой адаптер в состояние низкого энергопотребления, NDIS отправляет в драйвер мини-порта запрос на набор, содержащий объединенные параметры из всех запросов, хранимых NDIS.
Возможности, которые в настоящее время включены, могут быть подмножеством возможностей, поддерживаемых оборудованием. Дополнительные сведения о возможностях, поддерживаемых оборудованием, см. в разделе OID_PM_HARDWARE_CAPABILITIES.
Примечание Если NDIS задает флаг NDIS_PM_SELECTIVE_SUSPEND_ENABLED в элементе WakeUpFlagsструктуры NDIS_PM_PARAMETERS , он отправляет запрос набора OID OID_PM_PARAMETERS непосредственно драйверу мини-порта. Это позволяет NDIS обходить обработку с помощью драйверов фильтрации в стеке сетевых драйверов.
NDIS или драйвер мини-порта возвращает один из следующих кодов состояния для запроса:
NDIS_STATUS_SUCCESS
Запрос успешно выполнен.
NDIS_STATUS_PENDING
Запрос ожидает завершения. NDIS передает окончательный код состояния и результаты обработчику завершения запроса OID вызывающего объекта после завершения запроса.
NDIS_STATUS_BUFFER_TOO_SHORT
Буфер сведений был слишком коротким. NDIS задает data. QUERY_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального требуемого размера буфера.
NDIS_STATUS_INVALID_PARAMETER
Сбой запроса, так как он попытался включить возможность, которую не поддерживает базовый сетевой адаптер.
NDIS_STATUS_FAILURE
Запрос завершился сбоем по причинам, отличным от предыдущих.
Требования
Версия |
Поддерживается в NDIS 6.20 и более поздних версиях. |
Заголовок |
Ntddndis.h (включая Ndis.h) |