Freigeben über


WdfDmaTransactionGetDevice-Funktion (wdfdmatransaction.h)

[Gilt nur für KMDF]

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

Syntax

WDFDEVICE WdfDmaTransactionGetDevice(
  [in] WDFDMATRANSACTION DmaTransaction
);

Parameter

[in] DmaTransaction

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

Rückgabewert

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

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Hinweise

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

Beispiele

Im folgenden Codebeispiel wird ein Handle für das Framework-Geräteobjekt abgerufen, das einer angegebenen DMA-Transaktion zugeordnet ist.

WDFDEVICE device;

device = WdfDmaTransactionGetDevice(DmaTransaction);

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfdmatransaction.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WdfDmaTransactionCreate