Share via

OID_PM_CURRENT_CAPABILITIES

  • Статья

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

Комментарии

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

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

NDIS сообщает о возможностях управления питанием базового сетевого адаптера драйверам протоколов в элементе PowerManagementCapabilitiesEx структуры NDIS_BIND_PARAMETERS во время операции привязки. Поэтому драйверам протокола не нужно запрашивать OID.

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

Если базовый сетевой адаптер имеет драйвер мини-порта NDIS 6.1 или более ранней версии, NDIS преобразует возможности управления питанием базового сетевого адаптера в структуру NDIS_PM_CAPABILITIES .

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

NDIS_STATUS_SUCCESS
Запрос успешно выполнен. InformationBuffer указывает на структуру NDIS_PM_CAPABILITIES.

NDIS_STATUS_PENDING
Запрос ожидает завершения. NDIS передает окончательный код состояния и результаты обработчику завершения запроса 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_BIND_PARAMETERS

NDIS_OID_REQUEST

NDIS_PM_CAPABILITIES

NDIS_STATUS_PM_CAPABILITIES_CHANGE