OID_PM_REMOVE_PROTOCOL_OFFLOAD

  • Статья

В качестве набора запросов драйверы NDIS и протоколов используют OID OID_PM_REMOVE_PROTOCOL_OFFLOAD для удаления разгрузки протокола управления питанием с сетевого адаптера. Элемент InformationBuffer структуры NDIS_OID_REQUEST содержит указатель на идентификатор разгрузки протокола ULONG .

Комментарии

Драйверы NDIS и протоколов используют OID OID_PM_REMOVE_PROTOCOL_OFFLOAD для удаления разгрузки протокола из базового сетевого адаптера.

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

Примечания для модулей записи драйверов минипорта

NDIS гарантирует, что размер буфера равен по крайней мере sizeof (ULONG) и содержит допустимый идентификатор разгрузки протокола. Поэтому функция MiniportOidRequest драйвера мини-порта должна возвращать NDIS_STATUS_SUCCESS для этого запроса.

Примечание Если драйвер минипорта сбрасывается, его функция MiniportOidRequest должна возвращать NDIS_STATUS_NOT_ACCEPTED.

Коды состояния возврата

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

NDIS_STATUS_SUCCESS
Разгрузка протокола успешно удалена.

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

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

NDIS_STATUS_FILE_NOT_FOUND
Недопустимый идентификатор разгрузки протокола в запросе OID.

Требования

Версия

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

Заголовок

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

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

NDIS_OID_REQUEST

NDIS_PM_PROTOCOL_OFFLOAD

OID_PM_ADD_PROTOCOL_OFFLOAD