функция обратного вызова W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER (ndischimney.h)
[Функция разгрузки дымохода TCP является нерекомендуемой и не должна использоваться.]
NDIS вызывает функцию MiniportTcpOffloadReceiveReturn , чтобы вернуть права владения NET_BUFFER_LIST и связанными структурами в целевой объект разгрузки.
Синтаксис
W_TCP_OFFLOAD_RECEIVE_RETURN_HANDLER WTcpOffloadReceiveReturnHandler;
NDIS_STATUS WTcpOffloadReceiveReturnHandler(
[in] IN NDIS_HANDLE MiniportAdapterContext,
[in] IN PNET_BUFFER_LIST NetBufferList
)
{...}
Параметры
[in] MiniportAdapterContext
Дескриптор выделенной области контекста целевого объекта разгрузки, в которой целевой объект разгрузки сохраняет сведения о состоянии этого экземпляра адаптера. Драйвер минипорта предоставил этот дескриптор NDIS при вызове NdisMSetMiniportAttributes из его Функция MiniportInitializeEx .
[in] NetBufferList
Указатель на структуру NET_BUFFER_LIST . Эта структура может быть автономной или первой структурой в связанном списке NET_BUFFER_LIST структур. Связанный список может содержать NET_BUFFER_LIST структур из одного или нескольких вызовов кФункция NdisTcpOffloadReceiveHandler.
Возвращаемое значение
Функция MiniportTcpOffloadReceiveReturn всегда должна выполняться успешно. Поэтому функция MiniportTcpOffloadReceiveReturn всегда должна возвращать NDIS_STATUS_SUCCESS.
Комментарии
NDIS вызывает функцию MiniportTcpOffloadReceiveReturn , чтобы вернуть права собственности на NET_BUFFER_LIST структуры и связанные структуры, которые целевой объект разгрузки передал в одном или нескольких предыдущих вызовахФункция NdisTcpOffloadReceiveHandler.
Функция MiniportTcpOffloadReceiveReturn может подготовить возвращаемую структуру NET_BUFFER_LIST для использования в последующем указании получения. Хотя функция MiniportTcpOffloadReceiveReturn может возвращать NET_BUFFER_LIST структуры в пул (например, она может вызывать функцию NdisFreeNetBufferList ), может быть эффективнее повторно использовать структуры, не возвращая их в пул.
Обратите внимание, что драйвер целевого объекта разгрузки не должен выгружать, а адаптер целевого объекта разгрузки не должен быть закрыт до тех пор, пока не будут возвращены все указанные буферы приема.
Требования
Требование | Значение |
---|---|
Целевая платформа | Windows |
Header | ndischimney.h (включая Ndischimney.h) |
IRQL | Любой уровень |
См. также раздел
Обратная связь
https://aka.ms/ContentUserFeedback.
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе:Отправить и просмотреть отзыв по