NetDmaProviderStop function (netdma.h)

Article
02/22/2024

Note The NetDMA interface is not supported

in Windows 8 and later.

The NetDmaProviderStop function notifies the NetDMA interface that all of the DMA channels that are associated with a DMA provider are no longer available for DMA transfers.

Syntax

NET_DMA_EXPORT VOID NetDmaProviderStop(
  [in] PVOID NetDmaProviderHandle
);

Parameters

[in] NetDmaProviderHandle

A handle that identifies a DMA provider. The DMA provider driver received this handle from the NetDMA interface in a call to the NetDmaRegisterProvider function.

Return value

None

Remarks

A DMA provider driver calls the NetDmaProviderStop function to notify the NetDMA interface that a DMA engine, which was started by calling the NetDmaProviderStart function, is no longer available.

The DMA provider driver must call NetDmaProviderStop before it calls the NetDmaDeregisterProvider function to deregister a DMA provider.

DMA provider drivers typically call NetDmaProviderStop while handling the IRP_MN_REMOVE_DEVICE or IRP_MN_STOP_DEVICE IRP.

A DMA provider driver can call NetDmaProviderStop and NetDmaProviderStart as many times as the application requires after registering the DMA provider and before deregistering the DMA provider. If a DMA engine is being restarted after it called NetDmaProviderStop, the DMA provider driver can specify new attributes in the NET_DMA_PROVIDER_ATTRIBUTES structure at the ProviderAttributes parameter of NetDmaProviderStart.

The NetDMA interface waits for outstanding DMA operations to complete and frees all of the allocated DMA channels before it returns from the NetDmaProviderStop function.

Requirements

Requirement	Value
Minimum supported client	Supported for NetDMA 1.0 drivers in Windows Vista.
Target Platform	Universal
Header	netdma.h (include Netdma.h)
IRQL	PASSIVE_LEVEL