Функция NetDmaProviderStop (netdma.h)

Статья
02/07/2025

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

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

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

Синтаксис

NET_DMA_EXPORT VOID NetDmaProviderStop(
  [in] PVOID NetDmaProviderHandle
);

Параметры

[in] NetDmaProviderHandle

Дескриптор, определяющий поставщика DMA. Драйвер поставщика DMA получил этот дескриптор из интерфейса NetDMA в вызове функцию NetDmaRegisterProvider.

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

Никакой

Замечания

Драйвер поставщика DMA вызывает функцию NetDmaProviderStop, чтобы уведомить интерфейс NetDMA о том, что модуль DMA, который был запущен путем вызова функции NetDmaProviderStart, больше недоступен.

Драйвер поставщика DMA должен вызывать NetDmaProviderStop перед вызовом функции NetDmaDeregisterProvider для отмены регистрации поставщика DMA.

Драйверы поставщика DMA обычно вызывают NetDmaProviderStop при обработке IRP_MN_REMOVE_DEVICE или IRP_MN_STOP_DEVICE IRP.

Драйвер поставщика DMA может вызывать NetDmaProviderStop и NetDmaProviderStart столько раз, сколько требуется приложению после регистрации поставщика DMA и перед отменой регистрации поставщика DMA. Если подсистема DMA перезапускается после вызова NetDmaProviderStop, драйвер поставщика DMA может указать новые атрибуты в NET_DMA_PROVIDER_ATTRIBUTES структура ProviderAttributes параметра NetDmaProviderStart.

Интерфейс NetDMA ожидает завершения операций DMA и освобождает все выделенные каналы DMA, прежде чем он возвращается из функции NetDmaProviderStop.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Поддерживается для драйверов NetDMA 1.0 в Windows Vista.
целевая платформа	Всеобщий
заголовка	netdma.h (include Netdma.h)
IRQL	PASSIVE_LEVEL