WdfDmaTransactionGetDevice function (wdfdmatransaction.h)
[Applies to KMDF only]
The WdfDmaTransactionGetDevice method returns a handle to the framework device object that is associated with a specified DMA transaction.
Syntax
WDFDEVICE WdfDmaTransactionGetDevice(
[in] WDFDMATRANSACTION DmaTransaction
);
Parameters
[in] DmaTransaction
A handle to a DMA transaction object that the driver obtained from a previous call to WdfDmaTransactionCreate.
Return value
WdfDmaTransactionGetDevice returns a handle to the framework device object that the driver specified when it called WdfDmaTransactionCreate.
A bug check occurs if the driver supplies an invalid object handle.
Remarks
For more information about completing DMA transfers, see Completing a DMA Transfer.
Examples
The following code example obtains a handle to the framework device object that is associated with a specified DMA transaction.
WDFDEVICE device;
device = WdfDmaTransactionGetDevice(DmaTransaction);
Requirements
| Requirement | Value |
|---|---|
| Target Platform | Universal |
| Minimum KMDF version | 1.0 |
| Header | wdfdmatransaction.h (include Wdf.h) |
| Library | Wdf01000.sys (see Framework Library Versioning.) |
| IRQL | <=DISPATCH_LEVEL |
| DDI compliance rules | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |