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


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 и более поздних версиях. Обязательно для минипорт-драйверов. (См. раздел "Примечания".)

Заголовок

Ntddndis.h (include Ndis.h)

См. также

NDIS_PM_PROTOCOL_OFFLOAD

OID_PM_ADD_PROTOCOL_OFFLOAD