PutDmaAdapter routine

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

Syntax


VOID PutDmaAdapter(
  _In_ PDMA_ADAPTER DmaAdapter
);

Parameters

DmaAdapter [in]

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

Target platform

Version

Available starting with Windows 2000.

Header

Wdm.h (include Wdm.h, Ntddk.h, or Ntifs.h)

IRQL

<= DISPATCH_LEVEL

DDI compliance rules

IrqlDispatch

See also

DMA_ADAPTER
IoGetDmaAdapter
DMA_OPERATIONS

 

 

Send comments about this topic to Microsoft

Show: