OID_PM_PARAMETERS

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

В качестве набора драйверы протокола могут использовать OID_PM_PARAMETERS OID для включения или отключения текущих аппаратных возможностей сетевого адаптера. Драйвер протокола предоставляет указатель на структуру NDIS_PM_PARAMETERS в элементе InformationBuffer структуры NDIS_OID_REQUEST.

Замечания

Начиная с NDIS 6.20, переопределяющие протоколы и драйверы фильтров используют OID_PM_PARAMETERS для запроса и настройки возможностей оборудования управления питанием сетевого адаптера, который в настоящее время включен.

Когда драйвер чрезмерно запрашивает OID_PM_PARAMETERS OID, 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_OID_REQUEST

NDIS_PM_PARAMETERS

OID_PM_HARDWARE_CAPABILITIES