[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_FLAGSWDF_DMA_ENABLER_CONFIG_REQUIRE_SINGLE_TRANSFER 지정합니다. 이는 DMA 인에이블러를 사용하여 만든 각 트랜잭션 개체에 대해 WdfDmaTransactionSetSingleTransferRequirement 호출하는 것과 같습니다.
드라이버는 트랜잭션 개체를 만들거나 재활용한 후 초기화하거나 실행하기 전에 WdfDmaTransactionSetSingleTransferRequirement 호출합니다. 자세한 내용은 단일 전송 DMA 사용하는참조하세요.
WdfDmaTransactionSetSingleTransferRequirement DMA 버전 3이 필요합니다. DMA 버전 3을 선택하려면 WDF_DMA_ENABLER_CONFIGWdmDmaVersionOverride 멤버를 3으로 설정합니다.
요구 사항
| 요구 사항 | 가치 |
|---|---|
| 대상 플랫폼 | 보편적 |
| 최소 KMDF 버전 | 1.19 |
| 헤더 | wdfdmatransaction.h(Wdf.h 포함) |
| 라이브러리 | Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조) |
| IRQL | <=DISPATCH_LEVEL |