Funzione WdfDmaTransactionSetImmediateExecution (wdfdmatransaction.h)
[Si applica solo a KMDF]
Il metodo WdfDmaTransactionSetImmediateExecution contrassegna la transazione DMA specificata in modo che le chiamate a WdfDmaTransactionExecute e WdfDmaTransactionAllocateResources avviino immediatamente o hanno esito negativo.
Sintassi
void WdfDmaTransactionSetImmediateExecution(
[in] WDFDMATRANSACTION DmaTransaction,
[in] BOOLEAN UseImmediateExecution
);
Parametri
[in] DmaTransaction
Handle a un oggetto transazione DMA da contrassegnare per l'esecuzione immediata.
[in] UseImmediateExecution
Valore booleano che, se TRUE, indica che la transazione deve essere eseguita immediatamente (o ha esito negativo se le risorse non sono disponibili) e, se FALSE, indica che la transazione deve essere accodata per l'esecuzione una volta disponibili le risorse DMA.
Valore restituito
nessuno
Osservazioni
Prima di chiamare WdfDmaTransactionSetImmediateExecution, il driver deve inizializzare la transazione.
Se il driver chiama WdfDmaTransactionExecute o WdfDmaTransactionAllocateResources dopo aver chiamato WdfDmaTransactionSetImmediateExecution con UseImmediateExecution impostato su TRUE e le risorse necessarie per la richiesta non sono disponibili, tale metodo restituisce STATUS_INSUFFICIENT_RESOURCES. Se le risorse necessarie sono disponibili, il framework li dichiara e avvia la chiamata in modo sincrono.
Dopo che il driver contrassegna una transazione per l'esecuzione immediata, la transazione rimane contrassegnata come tale finché il driver chiama WdfDmaTransactionRelease o cancella il flag chiamando WdfDmaTransactionSetImmediateExecution con UseImmediateExecution impostato su FALSE.
WdfDmaTransactionSetImmediateExecution richiede DMA versione 3. Per selezionare DMA versione 3, impostare il membro WdmDmaVersionOverride di WDF_DMA_ENABLER_CONFIG su 3.
Se il driver chiama questo metodo in un sistema operativo precedente a Windows 8, il verificatore del framework segnala un errore.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows 8 |
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.11 |
| Intestazione | wdfdmatransaction.h (include Wdf.h) |
| Libreria | Wdf01000.sys (vedere Framework Library Versioning). |
| IRQL | <=DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf) |