WdfDmaTransactionSetImmediateExecution-Funktion (wdfdmatransaction.h)
[Gilt nur für KMDF]
Die WdfDmaTransactionSetImmediateExecution-Methode markiert die angegebene DMA-Transaktion, sodass Aufrufe von WdfDmaTransactionExecute und WdfDmaTransactionAllocateResources die Transaktion sofort initiieren oder fehlschlagen.
Syntax
void WdfDmaTransactionSetImmediateExecution(
[in] WDFDMATRANSACTION DmaTransaction,
[in] BOOLEAN UseImmediateExecution
);
Parameter
[in] DmaTransaction
Ein Handle für ein DMA-Transaktionsobjekt, das zur sofortigen Ausführung markiert werden soll.
[in] UseImmediateExecution
Ein boolescher Wert, der bei TRUE angibt, dass die Transaktion sofort ausgeführt werden soll (oder fehlschlägt, wenn Ressourcen nicht verfügbar sind), und bei FALSE, dass die Transaktion für die Ausführung in die Warteschlange eingereiht werden soll, sobald DMA-Ressourcen verfügbar sind.
Rückgabewert
Keine
Bemerkungen
Vor dem Aufrufen von WdfDmaTransactionSetImmediateExecution muss der Treiber die Transaktion initialisieren.
Wenn der Treiber WdfDmaTransactionExecute oder WdfDmaTransactionAllocateResources nach dem Aufruf von WdfDmaTransactionSetImmediateExecution aufruft , wobei UseImmediateExecution auf TRUE festgelegt ist und die für die Anforderung erforderlichen Ressourcen nicht verfügbar sind, gibt diese Methode STATUS_INSUFFICIENT_RESOURCES zurück. Wenn die erforderlichen Ressourcen verfügbar sind, beansprucht das Framework diese und initiiert den Aufruf synchron.
Nachdem der Treiber eine Transaktion für die sofortige Ausführung markiert hat, bleibt die Transaktion als solche gekennzeichnet, bis der Treiber WdfDmaTransactionRelease aufruft oder das Flag durch Aufrufen von WdfDmaTransactionSetImmediateExecution mit useImmediateExecution auf FALSE festgelegt.
WdfDmaTransactionSetImmediateExecution erfordert DMA Version 3. Um DMA-Version 3 auszuwählen, legen Sie das WdmDmaVersionOverride-Element von WDF_DMA_ENABLER_CONFIG auf 3 fest.
Wenn Ihr Treiber diese Methode auf einem früheren Betriebssystem als 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 (include Wdf.h) |
| Bibliothek | Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf) |