NetDmaProviderStop function (netdma.h)
in Windows 8 and later.
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 |