функция обратного вызова DMA_RESET_HANDLER (netdma.h)
в Windows 8 и более поздних версий.
Синтаксис
DMA_RESET_HANDLER DmaResetHandler;
NTSTATUS DmaResetHandler(
[in] PVOID ProviderChannelContext
)
{...}
Параметры
[in] ProviderChannelContext
Указатель, определяющий контекстную область канала DMA. Поставщик DMA вернул этот дескриптор в NetDMA в расположении, указанном в параметре pProviderChannelContext объекта Функция ProviderAllocateDmaChannel .
Возвращаемое значение
ProviderResetChannel возвращает одно из следующих значений состояния:
Код возврата | Описание |
---|---|
|
Операция выполнена успешно. |
|
Операция завершилась сбоем по неустановленным причинам. |
Комментарии
Функция ProviderResetChannel является необязательной для поставщиков NetDMA. Интерфейс NetDMA вызывает функцию ProviderResetChannel драйвера поставщика DMA для сброса канала DMA.
В 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 |