Função WdfDmaTransactionSetImmediateExecution (wdfdmatransaction.h)

[Aplica-se somente ao KMDF]

O método WdfDmaTransactionSetImmediateExecution marca a transação DMA especificada para que as chamadas para WdfDmaTransactionExecute e WdfDmaTransactionAllocateResources inicie a transação imediatamente ou falhe.

Sintaxe

VOID WdfDmaTransactionSetImmediateExecution(
  [in] WDFDMATRANSACTION DmaTransaction,
  [in] BOOLEAN           UseImmediateExecution
);

Parâmetros

[in] DmaTransaction

Um identificador para um objeto de transação DMA a ser marcado para execução imediata.

[in] UseImmediateExecution

Um valor booliano que, se VERDADEIRO, indica que a transação deve ser executada imediatamente (ou falhar se os recursos não estiverem disponíveis) e, se FALSE, indicar que a transação deve ser enfileirada para execução quando os recursos de DMA estiverem disponíveis.

Valor de retorno

Nenhum

Observações

Antes de chamar WdfDmaTransactionSetImmediateExecution, o driver deve inicializar a transação.

Se o driver chamar WdfDmaTransactionExecute ou WdfDmaTransactionAllocateResources depois de chamar WdfDmaTransactionSetImmediateExecution com UseImmediateExecution definido como TRUE, TRUE e os recursos necessários para a solicitação não estão disponíveis, esse método retorna STATUS_INSUFFICIENT_RESOURCES. Se os recursos necessários estiverem disponíveis, a estrutura os reivindicará e iniciará a chamada de forma síncrona.

Depois que o driver marca uma transação para execução imediata, a transação permanece marcada como tal até que o driver chame WdfDmaTransactionRelease ou limpe o sinalizador chamando WdfDmaTransactionSetImmediateExecution com UseImmediateExecution definido como FALSE.

WdfDmaTransactionSetImmediateExecution requer a versão 3 do DMA. Para selecionar o DMA versão 3, defina o WdmDmaVersionOverride membro do WDF_DMA_ENABLER_CONFIG como 3.

Se o driver chamar esse método em um sistema operacional anterior ao Windows 8, o verificador da estrutura relatará um erro.

Requisitos

Consulte também

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute

WdfDmaTransactionRelease