WdfDmaTransactionSetTransferCompleteCallback-Funktion (wdfdmatransaction.h)
[Gilt nur für KMDF]
Die WdfDmaTransactionSetTransferCompleteCallback-Methode registriert eine Rückruffunktion des Übertragungsvervollständigungsereignisses für eine DMA-Transaktion im Systemmodus.
Syntax
void WdfDmaTransactionSetTransferCompleteCallback(
[in] WDFDMATRANSACTION DmaTransaction,
[in, optional] PFN_WDF_DMA_TRANSACTION_DMA_TRANSFER_COMPLETE DmaCompletionRoutine,
[in, optional] PVOID DmaCompletionContext
);
Parameter
[in] DmaTransaction
Ein Handle für ein initialisiertes DMA-Transaktionsobjekt, für das der Rückruf für die Vervollständigung der Übertragung festgelegt oder gelöscht werden soll.
[in, optional] DmaCompletionRoutine
Ein Zeiger auf die EvtDmaTransactionDmaTransferComplete-Ereignisrückruffunktion des Treibers oder NULL, um eine zuvor festgelegte Rückruffunktion zu löschen.
[in, optional] DmaCompletionContext
Ein Zeiger auf einen Puffer, der den vom Treiber angegebenen Kontext enthält, der für die Rückruffunktion evtDmaTransactionDmaTransferComplete des Treibers (NULL) bereitgestellt werden soll.
Rückgabewert
Keine
Bemerkungen
Der Treiber ruft diese Methode auf, um eine Vervollständigungsroutine festzulegen, die das Framework aufruft, nachdem der System-DMA-Controller eine Übertragung abgeschlossen hat. Das Framework ruft den EvtDmaTransactionDmaTransferComplete-Rückruf des Treibers einmal für jede Übertragung in der Transaktion auf.
In der Regel führt ein Treiber in einer E/A-Warteschlangenereignisrückruffunktion die folgenden Schritte in dieser Reihenfolge aus:
- Ruft WdfDmaTransactionInitializeUsingRequest, WdfDmaTransactionInitialize oder WdfDmaTransactionInitializeUsingOffset auf, um das Transaktionsobjekt zu initialisieren.
- Ruft WdfDmaTransactionSetTransferCompleteCallback für das Transaktionsobjekt auf.
- Ruft WdfDmaTransactionExecute auf.
WdfDmaTransactionSetTransferCompleteCallback kann nur mit einem DMA-Enabler verwendet werden, der ein DMA-Profil im Systemmodus angibt.
Wenn Ihr Treiber diese Methode unter einem Betriebssystem vor Windows 8 aufruft, meldet die Überprüfung des Frameworks einen Fehler.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 |
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.11 |
| Kopfzeile | wdfdmatransaction.h (einschließen von Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf) |