WdfDmaTransactionSetSingleTransferRequirement-Funktion (wdfdmatransaction.h)
[Gilt nur für KMDF]
Die WdfDmaTransactionSetSingleTransferRequirement-Methode gibt an, dass eine DMA-Transaktion in einer einzelnen Übertragung abgeschlossen werden muss.
Syntax
void WdfDmaTransactionSetSingleTransferRequirement(
[in] WDFDMATRANSACTION DmaTransaction,
[in] BOOLEAN RequireSingleTransfer
);
Parameter
[in] DmaTransaction
Ein Handle für ein DMA-Transaktionsobjekt, das der Treiber aus einem vorherigen Aufruf von WdfDmaTransactionCreate abgerufen hat.
[in] RequireSingleTransfer
Ein boolescher Wert, der bei TRUE angibt, dass die DMA-Transaktion eine einzelne Übertragung erfordert.
Rückgabewert
Keine
Bemerkungen
Diese Methode fordert eine einzelne Übertragung nur für eine einzelne Transaktion an. Wenn das Transaktionsobjekt mit WdfDmaTransactionRelease wiederverwendet und neu initialisiert wird, wird diese Einstellung zurückgesetzt, ähnlich wie bei anderen Eigenschaften auf Transaktionsebene wie sofortige Ausführung und maximale Übertragungslänge.
Um eine einzelne Übertragung für alle DMA-Transaktionen anzufordern, die mit einem bestimmten DMA-Enabler erstellt wurden, geben Sie beim Aufrufen von WdfDmaEnablerCreate WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER in WDF_DMA_ENABLER_CONFIG_FLAGS an. Dies entspricht dem Aufrufen von WdfDmaTransactionSetSingleTransferRequirement für jedes Transaktionsobjekt, das mit dem DMA-Enabler erstellt wurde.
Der Treiber ruft WdfDmaTransactionSetSingleTransferRequirement auf, nachdem das Transaktionsobjekt erstellt oder wiederverwendet wurde, aber bevor es initialisiert oder ausgeführt wird. Weitere Informationen finden Sie unter Verwenden von Single Transfer DMA.
WdfDmaTransactionSetSingleTransferRequirement erfordert DMA Version 3. Um DMA-Version 3 auszuwählen, legen Sie das WdmDmaVersionOverride-Element von WDF_DMA_ENABLER_CONFIG auf 3 fest.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.19 |
| Kopfzeile | wdfdmatransaction.h (include Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).) |
| IRQL | <=DISPATCH_LEVEL |