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


OID_PM_PROTOCOL_OFFLOAD_LIST

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

Комментарии

NDIS обрабатывает запрос на драйверы мини-порта. Драйверы NDIS могут использовать OID_PM_PROTOCOL_OFFLOAD_LIST OID, чтобы получить список разгрузки протокола, заданных на базовом сетевом адаптере.

Для каждой структуры NDIS_PM_PROTOCOL_OFFLOAD в списке NDIS задает для элемента NextProtocolOffloadOffset смещение от начала буфера сведений об идентификаторе (т. е. начала буфера, на который указывает элемент InformationBufferструктуры NDIS_OID_REQUEST ) до начала следующей структуры NDIS_PM_PROTOCOL_OFFLOAD в списке. Смещение в элементе NextProtocolOffloadOffset последней структуры в списке равно нулю.

Если на сетевом адаптере не заданы разгрузки протокола, NDIS задает data. QUERY_INFORMATION. BytesWritten член структуры NDIS_OID_REQUEST к нулю и возвращает NDIS_STATUS_SUCCESS. Данные в data. QUERY_INFORMATION. Элемент InformationBuffer не изменяется NDIS.

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

NDIS_STATUS_SUCCESS
Запрос успешно завершен. InformationBuffer содержит указатель на список разгрузки протокола, если таковые есть.

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

NDIS_PM_PROTOCOL_OFFLOAD