Função WdfDmaTransactionGetBytesTransferred (wdfdmatransaction.h)

[Aplica-se somente ao KMDF]

O método WdfDmaTransactionGetBytesTransferred retorna o número total de bytes que foram transferidos para uma transação de DMA especificada.

Sintaxe

size_t WdfDmaTransactionGetBytesTransferred(
  [in] WDFDMATRANSACTION DmaTransaction
);

Parâmetros

[in] DmaTransaction

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

Retornar valor

WdfDmaTransactionGetBytesTransferred retorna o número total de bytes que foram transferidos para a transação de DMA especificada pelo parâmetro DmaTransaction .

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Os drivers baseados em estrutura normalmente chamam WdfDmaTransactionGetBytesTransferred de dentro de uma função de retorno de chamada de evento EvtInterruptDpc , depois que todas as transferências de DMA forem concluídas, para obter a contagem final de bytes transferidos. Os drivers normalmente usam a contagem de bytes final como entrada para o método WdfRequestCompleteWithInformation . Para obter mais informações sobre esse método, consulte Concluindo uma transação de DMA.

Exemplos

Para obter um exemplo de código que usa WdfDmaTransactionGetBytesTransferred, consulte WdfDmaTransactionDmaCompleted.

Requisitos

Confira também

EvtInterruptDpc

WdfDmaTransactionCreate

WdfDmaTransactionDmaCompleted

WdfRequestCompleteWithInformation