OID_PM_CURRENT_CAPABILITIES
В качестве запроса драйверы могут использовать OID_PM_CURRENT_CAPABILITIES OID для запроса доступных возможностей управления питанием сетевого адаптера. После успешного возврата из запроса 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 и более поздних версиях. Не запрашивается для минипорт-драйверов. (См. раздел "Примечания".) |
Заголовок |
Ntddndis.h (include Ndis.h) |