PPUT_DMA_ADAPTER callback function (wdm.h)

The PutDmaAdapter routine frees a DMA_ADAPTER structure previously allocated by IoGetDmaAdapter.

Syntax

PPUT_DMA_ADAPTER PputDmaAdapter;

void PputDmaAdapter(
  [in] PDMA_ADAPTER DmaAdapter
)
{...}

Parameters

[in] DmaAdapter

Pointer to the DMA_ADAPTER structure to be released.

Return value

None

Remarks

PutDmaAdapter is not a system routine that can be called directly by name. This routine is callable only by pointer from the address returned in a DMA_OPERATIONS structure. Drivers obtain the address of this routine by calling IoGetDmaAdapter.

PutDmaAdapter frees a DMA adapter object previously allocated by IoGetDmaAdapter. Drivers should call PutDmaAdapter after completing DMA operations and freeing any map registers and common buffer allocated with this adapter object. After PutDmaAdapter returns, the driver can no longer use the DMA adapter object.

A driver must call PutDmaAdapter when it receives a PnP IRP_MN_STOP_DEVICE request.

Requirements

Requirement Value
Minimum supported client Available starting with Windows 2000.
Target Platform Desktop
Header wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
IRQL <= DISPATCH_LEVEL
DDI compliance rules IrqlDispatch(wdm)

See also

DMA_ADAPTER

DMA_OPERATIONS

IoGetDmaAdapter