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

Статья
08/07/2023

Примечание Интерфейс NetDMA не поддерживается.

в Windows 8 и более поздних версий.

Функция ProviderResetChannel сбрасывает канал DMA в исходное состояние, которое существовало после выделения канала DMA.

Синтаксис

DMA_RESET_HANDLER DmaResetHandler;

NTSTATUS DmaResetHandler(
  [in] PVOID ProviderChannelContext
)
{...}

Параметры

[in] ProviderChannelContext

Указатель, определяющий контекстную область канала DMA. Поставщик DMA вернул этот дескриптор в NetDMA в расположении, указанном в параметре pProviderChannelContext объекта Функция ProviderAllocateDmaChannel .

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

ProviderResetChannel возвращает одно из следующих значений состояния:

Код возврата	Описание
STATUS_SUCCESS	Операция выполнена успешно.
STATUS_UNSUCCESSFUL	Операция завершилась сбоем по неустановленным причинам.

В ProviderResetChannel поставщик NetDMA должен немедленно завершить любую активную передачу без завершения передачи данных, связанных с текущим дескрипторов DMA. Если отчеты о состоянии завершения включены, подсистема DMA записывает состояние NetDmaTransferStatusHalted в адрес, указанный в элементах CompletionVirtualAddress и CompletionPhysicalAddress в структура NET_DMA_CHANNEL_PARAMETERS .

После завершения операции сброса канал DMA должен находиться в исходном состоянии, которое существовало после выделения канала. После того как интерфейс NetDMA вызывает ProviderResetChannel, поставщик DMA не сможет получить доступ к ранее отправленным дескрипторам DMA. Канал DMA должен быть готов к вызову функции ProviderStartDma в интерфейсе NetDMA.

NetDMA вызывает ProviderResetChannel по адресу IRQL <= DISPATCH_LEVEL.

Требования

Требование	Значение
Минимальная версия клиента	Поддерживается для драйверов NetDMA 1.0 в Windows Vista.
Целевая платформа	Windows
Header	netdma.h (включая Netdma.h)
IRQL	<= DISPATCH_LEVEL

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

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderStartDma

Поделиться через