Функция NdisMCoSendNetBufferListsComplete (ndis.h)

Функция NdisMCoSendNetBufferListsComplete возвращает связанный список NET_BUFFER_LIST структур вышестоящему драйверу и возвращает окончательное состояние запроса на отправку CoNDIS.

Синтаксис

void NdisMCoSendNetBufferListsComplete(
  [in] IN NDIS_HANDLE      NdisVcHandle,
  [in] IN PNET_BUFFER_LIST NetBufferLists,
  [in] IN ULONG            SendCompleteFlags
);

Параметры

[in] NdisVcHandle

Дескриптор, идентифицирующий виртуальное подключение (VC). Драйвер мини-порта получил этот дескриптор в качестве входного параметра для функции MiniportCoCreateVc , когда клиент настроит исходящий вызов или когда диспетчер вызовов создал VC для зарегистрированной клиентом точки доступа службы (SAP) для указания уведомления о входящих вызовах.

[in] NetBufferLists

Указатель на связанный список NET_BUFFER_LIST структур. Водитель минипорта получил NET_BUFFER_LIST структур в предыдущих вызовах Функция MiniportCoSendNetBufferLists .

[in] SendCompleteFlags

Флаги NDIS, которые можно объединить с побитовой операцией ИЛИ. Чтобы удалить все флаги, задайте для этого параметра значение 0. NdisMCoSendNetBufferListsComplete поддерживает флаг NDIS_SEND_COMPLETE_FLAGS_DISPATCH_LEVEL, который; Значение , если задано, указывает, что текущий IRQL DISPATCH_LEVEL. Дополнительные сведения об этом флаге см. в разделе Dispatch IRQL Tracking.

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

None

Remarks

Драйвер минипорта вызывает NdisMCoSendNetBufferListsComplete для выполнения запросов, выполненных NDIS, к драйверу Функция MiniportCoSendNetBufferLists . Драйвер мини-порта задает связанный список NET_BUFFER_LIST структур, связанных с завершенными запросами на отправку.

Пока запросы на отправку находятся в состоянии ожидания, драйвер мини-порта сохраняет право собственности на структуры NET_BUFFER_LIST и все ресурсы, связанные с NET_BUFFER_LIST структурами.

После того как драйвер мини-порта вызывает NdisMCoSendNetBufferListsComplete, NDIS возвращает NET_BUFFER_LIST структуры и связанные данные в вышестоящему драйверу, создавщему запрос на отправку.

Драйвер мини-порта может отправлять запросы в любом порядке. Например, драйвер мини-порта может объединить NET_BUFFER_LIST списки структуры из нескольких вызовов MiniportCoSendNetBufferLists или разделить список из вызова MiniportCoSendNetBufferLists . Однако драйвер мини-порта не должен изменять список NET_BUFFER структур, связанных со структурой NET_BUFFER_LIST.

Драйвер miniport должен задать один из следующих кодов состояния в элементе Status каждой структуры NET_BUFFER_LIST, указанной параметром NetBufferLists :

Вызов драйвера минипорта к NdisMCoSendNetBufferListsComplete не обязательно указывает, что данные для запроса на отправку были переданы по сети. Например, данные могут быть помещены в очередь на оборудовании сетевого адаптера.

Требования

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

MiniportCancelSend

MiniportCoCreateVc

NET_BUFFER

NET_BUFFER_LIST