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


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

Примечание Интерфейс 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

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

IRP_MN_REMOVE_DEVICE

IRP_MN_STOP_DEVICE

NET_DMA_PROVIDER_ATTRIBUTES

NetDmaDeregisterProvider

NetDmaProviderStart

NetDmaRegisterProvider