Freigeben über


WdfDmaTransactionGetDevice-Funktion (wdfdmatransaction.h)

[Gilt nur für KMDF]

Die WdfDmaTransactionGetDevice--Methode gibt ein Handle an das Framework-Geräteobjekt zurück, das einer angegebenen DMA-Transaktion zugeordnet ist.

Syntax

WDFDEVICE WdfDmaTransactionGetDevice(
  [in] WDFDMATRANSACTION DmaTransaction
);

Die Parameter

[in] DmaTransaction

Ein Handle für ein DMA-Transaktionsobjekt, das der Treiber aus einem vorherigen Aufruf von WdfDmaTransactionCreateabgerufen hat.

Rückgabewert

WdfDmaTransactionGetDevice gibt ein Handle an das Framework-Geräteobjekt zurück, das der Treiber beim Aufrufen WdfDmaTransactionCreateangegeben hat.

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Bemerkungen

Weitere Informationen zum Abschließen von DMA-Übertragungen finden Sie unter Abschließen einer DMA-Übertragung.

Beispiele

Das folgende Codebeispiel ruft ein Handle für das Framework-Geräteobjekt ab, das einer angegebenen DMA-Transaktion zugeordnet ist.

WDFDEVICE device;

device = WdfDmaTransactionGetDevice(DmaTransaction);

Anforderungen

Anforderung Wert
Zielplattform universell
Minimale KMDF-Version 1.0
Kopfzeile wdfdmatransaction.h (include Wdf.h)
Bibliothek Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

WdfDmaTransactionCreate