// wdfdmatransaction.h
WDFREQUEST WdfDmaTransactionGetRequest(
[in] WDFDMATRANSACTION DmaTransaction
);
View the official Windows Driver Kit DDI referenceNo description available.
[Applies to KMDF only]
The WdfDmaTransactionGetRequest method retrieves a handle to the framework request object that is associated with a specified DMA transaction.
DmaTransaction [in]A handle to a DMA transaction object that the driver obtained from a previous call to WdfDmaTransactionCreate.
WdfDmaTransactionGetRequest returns a handle to the framework request object that is associated with the DMA transaction that the DmaTransaction parameter specified.
A bug check occurs if the driver supplies an invalid object handle.
A driver can call WdfDmaTransactionGetRequest only for DMA transactions that the driver created by calling WdfDmaTransactionInitializeUsingRequest. If a driver calls WdfDmaTransactionGetRequest for a DMA transaction that it created by calling WdfDmaTransactionInitialize, WdfDmaTransactionGetRequest returns NULL.
For more information about completing DMA transfers, see Completing a DMA Transfer.
The following code example obtains a handle to the framework request object that is associated with a specified DMA transaction.
WDFREQUEST request;
request = WdfDmaTransactionGetRequest(dmaTransaction);
WdfDmaTransactionInitializeUsingRequest