NdisMDeregisterScatterGatherDma function (ndis.h)
Caution
For ARM and ARM64 processors, we strongly recommend that NDIS driver writers use WDF DMA or WDM DMA instead of NDIS Scatter/Gather DMA.
For more information about WDF DMA, see Handling DMA Operations in KMDF Drivers.
For more information about WDM DMA, see the DMA-related child topics of Managing Input/Output for Drivers.
Bus-master miniport drivers call NdisMDeregisterScatterGatherDma to release DMA resources that were allocated with the NdisMRegisterScatterGatherDma function.
Syntax
void NdisMDeregisterScatterGatherDma(
[in] NDIS_HANDLE NdisMiniportDmaHandle
);
Parameters
[in] NdisMiniportDmaHandle
A handle to a context area that NDIS uses to manage a DMA resource. The caller obtained this handle by calling the NdisMRegisterScatterGatherDma function.
Return value
None
Remarks
An NDIS miniport driver calls NdisMDeregisterScatterGatherDma from its MiniportHaltEx function to release the DMA resources it allocated and initialized in a previous call to NdisMRegisterScatterGatherDma.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Supported in NDIS 6.0 and later. |
| Target Platform | Universal |
| Header | ndis.h (include Ndis.h) |
| Library | Ndis.lib |
| IRQL | PASSIVE_LEVEL |
| DDI compliance rules | Init_RegisterSG(ndis), Irql_Gather_DMA_Function(ndis) |