функция обратного вызова INITIATE_OFFLOAD_COMPLETE_HANDLER (ndischimney.h)

Статья
02/26/2024

[Функция разгрузки дымохода TCP является нерекомендуемой и не должна использоваться.]

NDIS вызывает функцию ProtocolInitiateOffloadComplete драйвера протокола или промежуточного драйвера для завершения операции разгрузки, которую драйвер ранее инициировал, вызвав функцию NdisInitiateOffload .

Синтаксис

INITIATE_OFFLOAD_COMPLETE_HANDLER InitiateOffloadCompleteHandler;

void InitiateOffloadCompleteHandler(
  [in] IN NDIS_HANDLE ProtocolBindingContext,
  [in] IN PNDIS_PROTOCOL_OFFLOAD_BLOCK_LIST OffloadBlockList
)
{...}

Параметры

[in] ProtocolBindingContext

Дескриптор области контекста, выделенной драйвером протокола. Драйвер сохраняет сведения о контексте привязки в этой области контекста. Драйвер предоставил этот дескриптор NDIS, когда драйвер вызвал функцию NdisOpenAdapterEx .

[in] OffloadBlockList

Указатель на NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST структуру, которая может быть автономной структурой или корнем связанного списка таких структур. Эти структуры идентифицируют состояние, которое было разгружено или которое пытались разгрузить.

Возвращаемое значение

None

Remarks

В ответ на вызов базового целевого объекта разгрузки или вызова промежуточного драйвера к функции NdisMInitiateOffloadComplete NDIS вызывает функцию ProtocolInitiateOffloadComplete протокола или промежуточного драйвера.

Промежуточный драйвер должен распространить завершение операции инициации разгрузки на драйвер над ним, вызвав NdisMInitiateOffloadComplete. Дополнительные сведения см. в разделе Распространение завершения операции State-Manipulation.

Из структуры NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST, переданной функции ProtocolInitiateOffloadComplete , промежуточный драйвер создает структуру NDIS_MINIPORT_OFFLOAD_BLOCK_LIST .

Дополнительные сведения см. в разделе Повторное использованием структуры NDIS_PROTOCOL_OFFLOAD_BLOCK_LIST. При вызове функции NdisMInitiateOffloadComplete промежуточный драйвер передает указатель (параметр OffloadBlockList ) на новую структуру NDIS_MINIPORT_OFFLOAD_BLOCK_LIST.