Макрос NdisMSetupDmaTransfer (ndis.h)

Статья
08/07/2023

Функция NdisMSetupDmaTransfer настраивает контроллер DMA узла для передачи данных DMA.

Синтаксис

void NdisMSetupDmaTransfer(
   _S,
   _H,
   _B,
   _O,
   _L,
   _M_
);

Параметры

_S

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

NDIS_STATUS_SUCCESS

Контроллер DMA настроен для передачи указанных данных, которые были удалены на устройство или с него для обеспечения целостности данных.

NDIS_STATUS_RESOURCES

Попытка настроить контроллер DMA для передачи завершилась сбоем из-за того, что канал, назначенный MiniportDmaHandle , в настоящее время использует передачу данных, или потому, что указанная длина недопустима.

_H

Дескриптор DMA, возвращаемый функцией NdisMRegisterDmaChannel во время инициализации.

_B

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

_O

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

_L

Количество байтов передаваемых данных. Диапазон, заданный смещением и длиной , должен быть правильным поддиалогом, указанным в буфере .

_M_

Логическое значение, равное TRUE для исходящей передачи из системы через сетевой адаптер. В противном случае — FALSE.

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

None

Remarks

Драйверы подчиненных сетевых адаптеров DMA вызывают NdisMSetupDmaTransfer в ответ на входящие запросы на отправку, для которых драйвер устанавливает для WriteToDevice значение TRUE. Они устанавливают для WriteToDeviceзначение FALSE при передаче полученных данных из сетевого адаптера в память узла.

Вызывающий объект NdisMSetupDmaTransfer предоставляет дескриптор буфера, сопоставляющий диапазон памяти узла, который является целевым объектом передачи или содержит данные для операции скачивания с узла на сетевой адаптер. Чтобы указать размер передачи в соответствии с ограничениями DMA сетевой карты, вызывающий объект может при необходимости настроить поддиапзон для передачи с параметрами Offset и Length .

Вызывающий объект должен предоставить дескриптор буфера, указывающий диапазон узлов, в который будут передаваться полученные данные из сетевого адаптера, если writeToDevice имеет значение FALSE. В противном случае дескриптор буфера в buffer был привязан к входным данным дескриптора пакета для драйвера мини-порта.Функция MiniportSendNetBufferLists.

Чтобы повысить производительность небольших запросов на передачу, таких как запрос на отправку длиной менее 256 байт, драйвер мини-порта может скопировать данные пакета во внутренний промежуточный буфер и передать сопоставление дескриптора буфера, выделенного драйвером, в NdisMSetupDmaTransfer.

При возвращении из NdisMSetupDmaTransfer контроллер DMA узла запрограммирован для передачи. Затем драйвер мини-порта программируйте сетевой адаптер для операции передачи.

После завершения передачи драйвер мини-порта должен вызватьФункция NdisMCompleteDmaTransfer.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается для драйверов NDIS 6.0 и NDIS 5.1 (см. раздел NdisMSetupDmaTransfer (NDIS 5.1)) в Windows Vista. Поддерживается для драйверов NDIS 5.1 (см. раздел NdisMSetupDmaTransfer (NDIS 5.1)) в Windows XP.
Целевая платформа	Универсальное
Верхняя часть	ndis.h (включая Ndis.h)
IRQL	<= DISPATCH_LEVEL
Правила соответствия DDI	Irql_Miniport_Driver_Function(ndis)