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

Статья
08/07/2023

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

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

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

Синтаксис

NET_DMA_EXPORT VOID NetDmaProviderStop(
  [in] PVOID NetDmaProviderHandle
);

Параметры

[in] NetDmaProviderHandle

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

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

None

Remarks

Драйвер поставщика 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 (включая Netdma.h)
IRQL	PASSIVE_LEVEL