Condividi tramite


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)

Vedi anche

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute

WdfDmaTransactionRelease