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
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdfdmatransaction.h (include Wdf.h) |
| Biblioteca | Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.) |
| IRQL | <=DISPATCH_LEVEL |
| Regras de conformidade da DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |