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) |