WdfDmaTransactionGetRequest-Funktion (wdfdmatransaction.h)
[Gilt nur für KMDF]
Die WdfDmaTransactionGetRequest-Methode ruft ein Handle für das Frameworkanforderungsobjekt ab, das einer angegebenen DMA-Transaktion zugeordnet ist.
Syntax
WDFREQUEST WdfDmaTransactionGetRequest(
[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
WdfDmaTransactionGetRequest gibt ein Handle für das Frameworkanforderungsobjekt zurück, das der vom DmaTransaction-Parameter angegebenen DMA-Transaktion zugeordnet ist.
Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Ein Treiber kann WdfDmaTransactionGetRequest nur für DMA-Transaktionen aufrufen, die der Treiber durch Aufrufen von WdfDmaTransactionInitializeUsingRequest erstellt hat. Wenn ein Treiber WdfDmaTransactionGetRequest für eine DMA-Transaktion aufruft, die er durch Aufrufen von WdfDmaTransactionInitialize erstellt hat, gibt WdfDmaTransactionGetRequestNULL zurück.
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 Frameworkanforderungsobjekt abgerufen, das einer angegebenen DMA-Transaktion zugeordnet ist.
WDFREQUEST request;
request = WdfDmaTransactionGetRequest(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) |