Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
[Gilt nur für KMDF]
Die WdfDmaTransactionGetRequest Methode ruft ein Handle für das Framework-Anforderungsobjekt ab, das einer angegebenen DMA-Transaktion zugeordnet ist.
Syntax
WDFREQUEST WdfDmaTransactionGetRequest(
[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
WdfDmaTransactionGetRequest gibt ein Handle an das Framework-Anforderungsobjekt zurück, das der DMA-Transaktion zugeordnet ist, die vom angegebenen DmaTransaction-Parameter angegeben wird.
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Bemerkungen
Ein Treiber kann WdfDmaTransactionGetRequest- nur für DMA-Transaktionen aufrufen, die der treiber erstellt hat, indem er WdfDmaTransactionInitializeUsingRequestaufruft. Wenn ein Treiber WdfDmaTransactionGetRequest für eine DMA-Transaktion aufruft, die er durch Aufrufen WdfDmaTransactionInitialize, WdfDmaTransactionGetRequestNULL-zurückgibt.
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-Anforderungsobjekt ab, das einer angegebenen DMA-Transaktion zugeordnet ist.
WDFREQUEST request;
request = WdfDmaTransactionGetRequest(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) |