Função WdfDmaTransactionSetSingleTransferRequirement (wdfdmatransaction.h)

Artigo
2025-03-22

[Aplica-se somente ao KMDF]

O método WdfDmaTransactionSetSingleTransferRequirement especifica que uma transação DMA deve ser concluída em uma única transferência.

Sintaxe

void WdfDmaTransactionSetSingleTransferRequirement(
  [in] WDFDMATRANSACTION DmaTransaction,
  [in] BOOLEAN           RequireSingleTransfer
);

Parâmetros

[in] DmaTransaction

Um identificador para um objeto de transação DMA que o driver obteve de uma chamada anterior para WdfDmaTransactionCreate.

[in] RequireSingleTransfer

Um valor booliano que, se VERDADEIRO, especifica que a transação DMA requer uma única transferência.

Valor de retorno

Nenhum

Observações

Esse método solicita apenas uma única transferência para uma única transação. Quando o objeto de transação é reciclado com WdfDmaTransactionRelease e reinicializado, essa configuração é redefinida, semelhante a outras propriedades no nível da transação, como execução imediata e comprimento máximo de transferência.

Para solicitar a transferência única para todas as transações de DMA criadas com um determinado habilitador de DMA, especifique WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER em WDF_DMA_ENABLER_CONFIG_FLAGS ao chamar WdfDmaEnablerCreate. Isso equivale a chamar WdfDmaTransactionSetSingleTransferRequirement para cada objeto de transação criado com o habilitador de DMA.

O driver chama WdfDmaTransactionSetSingleTransferRequirement depois de criar ou reciclar o objeto de transação, mas antes de inicializá-lo ou executá-lo. Para obter mais informações, consulte Usandode DMA de Transferência Única.

WdfDmaTransactionSetSingleTransferRequirement 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.

Requisitos

Requisito	Valor
da Plataforma de Destino	Universal
versão mínima do KMDF	1,19
cabeçalho	wdfdmatransaction.h (inclua Wdf.h)
Biblioteca	Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.)
IRQL	<=DISPATCH_LEVEL

Consulte também

WdfDmaTransactionCreate

WdfDmaTransactionInitialize

WdfDmaTransactionInitializeUsingRequest

Compartilhar via