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)

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

NDIS_OID_REQUEST

NDIS_PM_PARAMETERS

OID_PM_HARDWARE_CAPABILITIES