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)

See also

WdfDmaTransactionCreate