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

추가 정보

WdfDmaTransactionCreate

WdfDmaTransactionInitialize

WdfDmaTransactionInitializeUsingRequest