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 WdfDmaTransactionSetSingleTransferRequirement Methode gibt an, dass eine DMA-Transaktion in einer einzigen Übertragung abgeschlossen werden muss.
Syntax
void WdfDmaTransactionSetSingleTransferRequirement(
[in] WDFDMATRANSACTION DmaTransaction,
[in] BOOLEAN RequireSingleTransfer
);
Die Parameter
[in] DmaTransaction
Ein Handle für ein DMA-Transaktionsobjekt, das der Treiber aus einem vorherigen Aufruf von WdfDmaTransactionCreateabgerufen hat.
[in] RequireSingleTransfer
Ein boolescher Wert, der, wenn TRUE, angibt, dass für die DMA-Transaktion eine einzelne Übertragung erforderlich ist.
Rückgabewert
Nichts
Bemerkungen
Diese Methode fordert nur eine einzelne Übertragung für eine einzelne Transaktion an. Wenn das Transaktionsobjekt mit WdfDmaTransactionRelease und erneut initialisiert wird, wird diese Einstellung zurückgesetzt, ähnlich wie andere Eigenschaften auf Transaktionsebene, z. B. sofortige Ausführung und maximale Übertragungslänge.
Wenn Sie eine einzelne Übertragung für alle DMA-Transaktionen anfordern möchten, die mit einem bestimmten DMA-Enabler erstellt wurden, geben Sie WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER in WDF_DMA_ENABLER_CONFIG_FLAGS an, wenn Sie WdfDmaEnablerCreateaufrufen. Dies entspricht dem Aufrufen WdfDmaTransactionSetSingleTransferRequirement- für jedes Transaktionsobjekt, das mit dem DMA-Enabler erstellt wurde.
Der Treiber ruft WdfDmaTransactionSetSingleTransferRequirement nach dem Erstellen oder Recycling des Transaktionsobjekts auf, aber bevor es initialisiert oder ausgeführt wird. Weitere Informationen finden Sie unter Using Single Transfer DMA.
WdfDmaTransactionSetSingleTransferRequirement erfordert DMA Version 3. Um DMA Version 3 auszuwählen, legen Sie den WdmDmaVersionOverride Mitglied von WDF_DMA_ENABLER_CONFIG auf 3 fest.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.19 |
| Kopfzeile | wdfdmatransaction.h (include Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL | <=DISPATCH_LEVEL |