WdfDmaTransactionRelease - NtDoc
Native API online documentation, based on the System Informer
(formerly Process Hacker) phnt
headers
// wdfdmatransaction.h
NTSTATUS WdfDmaTransactionRelease(
[in] WDFDMATRANSACTION DmaTransaction
);
View the official Windows Driver Kit DDI referenceNo description available.
[Applies to KMDF only]
The WdfDmaTransactionRelease method terminates a specified DMA transaction without deleting the associated DMA transaction object.
DmaTransaction [in]A handle to a DMA transaction object that the driver obtained from a previous call to WdfDmaTransactionCreate.
WdfDmaTransactionRelease returns STATUS_SUCCESS if the operation succeeds. Otherwise, the method might return the following value:
| Return code | Description |
|---|---|
| STATUS_INVALID_DEVICE_STATE | The driver has already released or deleted the transaction object that the DmaTransaction parameter specified. |
This method also might return other NTSTATUS values.
A bug check occurs if the driver supplies an invalid object handle.
The WdfDmaTransactionRelease method flushes transfer buffers and releases all of the system resources that are associated with the DMA transaction. The transaction object is not deleted and can be reused. For more information about reusing transaction objects, see Reusing DMA Transaction Objects.
If WdfDmaTransactionInitializeXxx returns success but WdfDmaTransactionExecute returns an error value, your driver must call WdfDmaTransactionRelease.
The following code example terminates the DMA transaction that the specified DMA transaction object represents, but it does not delete the DMA transaction object.
NTSTATUS status;
status = WdfDmaTransactionRelease(dmaTransaction);