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) |