Поделиться через


OID_PM_GET_PROTOCOL_OFFLOAD

Избыточный драйвер выдает запрос метода OID OID_PM_GET_PROTOCOL_OFFLOAD для получения параметров для разгрузки протокола с низким энергопотреблением от сетевого адаптера.

Элемент InformationBuffer структуры NDIS_OID_REQUEST изначально содержит указатель на идентификатор разгрузки протокола ULONG. После успешного возврата из запроса метода OID элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на структуру NDIS_PM_PROTOCOL_OFFLOAD .

Комментарии

Драйверы протокола NDIS 6.20 и более поздних версий используют OID_PM_GET_PROTOCOL_OFFLOAD метод OID для получения параметров для разгрузки протокола с низким энергопотреблением из сетевого адаптера.

Информационный буфер должен указывать на идентификатор разгрузки протокола ULONG. NDIS задает этот идентификатор разгрузки протокола в элементе ProtocolOffloadId структуры NDIS_PM_PROTOCOL_OFFLOAD , когда NDIS отправляет предыдущий запрос OID_PM_ADD_PROTOCOL_OFFLOAD OID базовому сетевому адаптеру.

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

NDIS_STATUS_SUCCESS
Запрошенные данные были успешно получены. Информационный буфер содержит соответствующую структуру NDIS_PM_PROTOCOL_OFFLOAD.

NDIS_STATUS_PENDING
Запрос ожидает завершения. Окончательный код состояния и результаты будут переданы обработчику завершения запроса OID вызывающего объекта.

NDIS_STATUS_INVALID_PARAMETER
Указанный идентификатор разгрузки протокола недопустим.

NDIS_STATUS_BUFFER_TOO_SHORT
Буфер сведений был слишком коротким. NDIS задает значение DATA. QUERY_INFORMATION. Элемент BytesNeeded в NDIS_OID_REQUEST структуру до минимального необходимого размера буфера.

NDIS_STATUS_NOT_SUPPORTED
Версия NDIS драйвера мини-порта ниже 6.20.

NDIS_STATUS_FAILURE
Сбой запроса по причинам, не указанным выше.

Требования

Версия

Поддерживается в NDIS 6.20 и более поздних версиях. Обязательно для водителей минипорта. (См. раздел примeчаний).

Заголовок

Ntddndis.h (включая Ndis.h)

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

NDIS_PM_PROTOCOL_OFFLOAD

OID_PM_ADD_PROTOCOL_OFFLOAD