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)

Weitere Informationen

WdfDmaTransactionCreate

WdfDmaTransactionInitialize

WdfDmaTransactionInitializeUsingRequest