OID_PM_PROTOCOL_OFFLOAD_LIST
В качестве запроса движущиеся драйверы могут использовать OID_PM_PROTOCOL_OFFLOAD_LIST OID для перечисления отключений протокола, установленных на базовом сетевом адаптере. После успешного возврата из запроса OID InformationBuffer член структуры NDIS_OID_REQUEST содержит указатель на список структур NDIS_PM_PROTOCOL_OFFLOAD, описывающих разгрузки текущего активного протокола.
Замечания
NDIS обрабатывает запрос для мини-драйверов. Драйверы NDIS могут использовать OID_PM_PROTOCOL_OFFLOAD_LIST OID для получения списка отключений протокола, установленных на базовом сетевом адаптере.
Для каждой структуры NDIS_PM_PROTOCOL_OFFLOAD в списке NDIS задает элемент NextProtocolOffloadOffset смещение с начала буфера сведений об OID (то есть начало буфера, на который 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 и более поздних версиях. Не запрашивается для минипорт-драйверов. (См. раздел "Примечания".) |
Заголовок |
Ntddndis.h (include Ndis.h) |