WdfDmaTransactionSetSingleTransferRequirement 함수(wdfdmatransaction.h)
[KMDF에만 적용]
WdfDmaTransactionSetSingleTransferRequirement 메서드는 DMA 트랜잭션이 단일 전송에서 완료되도록 지정합니다.
구문
void WdfDmaTransactionSetSingleTransferRequirement(
[in] WDFDMATRANSACTION DmaTransaction,
[in] BOOLEAN RequireSingleTransfer
);
매개 변수
[in] DmaTransaction
드라이버가 WdfDmaTransactionCreate에 대한 이전 호출에서 가져온 DMA 트랜잭션 개체에 대한 핸들입니다.
[in] RequireSingleTransfer
TRUE인 경우 DMA 트랜잭션에 단일 전송이 필요하도록 지정하는 부울 값입니다.
반환 값
없음
설명
이 메서드는 단일 트랜잭션에 대해서만 단일 전송을 요청합니다. 트랜잭션 개체가 WdfDmaTransactionRelease 로 재활용되고 다시 초기화되면 이 설정은 즉시 실행 및 최대 전송 길이와 같은 다른 트랜잭션 수준 속성과 유사하게 다시 설정됩니다.
지정된 DMA 지원자를 사용하여 만든 모든 DMA 트랜잭션에 대해 단일 전송을 요청하려면 WdfDmaEnablerCreate를 호출할 때 WDF_DMA_ENABLER_CONFIG_FLAGS WDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER지정합니다. 이는 DMA 사용으로 만든 각 트랜잭션 개체에 대해 WdfDmaTransactionSetSingleTransferRequirement 를 호출하는 것과 같습니다.
드라이버는 트랜잭션 개체를 만들거나 재활용한 후 초기화하거나 실행하기 전에 WdfDmaTransactionSetSingleTransferRequirement 를 호출합니다. 자세한 내용은 단일 전송 DMA 사용을 참조하세요.
WdfDmaTransactionSetSingleTransferRequirement 에는 DMA 버전 3이 필요합니다. DMA 버전 3을 선택하려면 WDF_DMA_ENABLER_CONFIG WdmDmaVersionOverride 멤버를 3으로 설정합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 최소 KMDF 버전 | 1.19 |
| 머리글 | wdfdmatransaction.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조) |
| IRQL | <=DISPATCH_LEVEL |