다음을 통해 공유


WdfDmaTransactionGetBytesTransferred 함수(wdfdmatransaction.h)

[KMDF에만 적용]

WdfDmaTransactionGetBytesTransferred 메서드는 지정된 DMA 트랜잭션에 대해 전송된 총 바이트 수를 반환합니다.

구문

size_t WdfDmaTransactionGetBytesTransferred(
  [in] WDFDMATRANSACTION DmaTransaction
);

매개 변수

[in] DmaTransaction

드라이버가 WdfDmaTransactionCreate에 대한 이전 호출에서 가져온 DMA 트랜잭션 개체에 대한 핸들입니다.

반환 값

WdfDmaTransactionGetBytesTransferredDmaTransaction 매개 변수가 지정한 DMA 트랜잭션에 대해 전송된 총 바이트 수를 반환합니다.

드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.

설명

프레임워크 기반 드라이버는 일반적으로 모든 DMA 전송이 완료된 후 EvtInterruptDpc 이벤트 콜백 함수 내에서 WdfDmaTransactionGetBytesTransferred를 호출하여 최종 전송된 바이트 수를 가져옵니다. 드라이버는 일반적으로 WdfRequestCompleteWithInformation 메서드에 대한 입력으로 최종 바이트 수를 사용합니다. 이 메서드에 대한 자세한 내용은 DMA 트랜잭션 완료를 참조하세요.

예제

WdfDmaTransactionGetBytesTransferred를 사용하는 코드 예제는 WdfDmaTransactionDmaCompleted를 참조하세요.

요구 사항

요구 사항
대상 플랫폼 유니버설
최소 KMDF 버전 1.0
머리글 wdfdmatransaction.h(Wdf.h 포함)
라이브러리 Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조)
IRQL <=DISPATCH_LEVEL
DDI 규정 준수 규칙 DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

추가 정보

EvtInterruptDpc

WdfDmaTransactionCreate

WdfDmaTransactionDmaCompleted

WdfRequestCompleteWithInformation