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

Синтаксис

DMA_RESET_HANDLER DmaResetHandler;

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

Параметры

[in] ProviderChannelContext

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

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

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

Замечания

Функция ProviderResetChannel является необязательной функцией для поставщиков NetDMA. Интерфейс NetDMA вызывает функцию драйвера поставщика DMA ProviderResetChannel, чтобы сбросить канал DMA.

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

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

NetDMA вызывает ProviderResetChannel в IRQL <= DISPATCH_LEVEL.

Требования

См. также

NET_DMA_CHANNEL_PARAMETERS

ProviderAllocateDmaChannel

ProviderStartDma