NdisMDeregisterScatterGatherDma function (ndis.h)

Article
02/22/2024

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)