다음을 통해 공유


WdfDmaTransactionGetTransferInfo 함수(wdfdmatransaction.h)

[KMDF에만 적용]

WdfDmaTransactionGetTransferInfo 메서드는 초기화된 DMA 트랜잭션에 필요한 맵 레지스터 및 분산/수집 목록 항목의 수를 반환합니다.

구문

void WdfDmaTransactionGetTransferInfo(
  [in]            WDFDMATRANSACTION DmaTransaction,
  [out, optional] ULONG             *MapRegisterCount,
  [out, optional] ULONG             *ScatterGatherElementCount
);

매개 변수

[in] DmaTransaction

초기화된 DMA 트랜잭션 개체에 대한 핸들입니다.

[out, optional] MapRegisterCount

반환할 때 지정된 트랜잭션에 필요한 맵 레지스터 수를 포함하는 호출자가 제공한 위치입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

[out, optional] ScatterGatherElementCount

반환 시 지정된 트랜잭션에 필요한 분산/수집 요소의 수를 포함하는 호출자가 제공한 위치입니다. 이 매개 변수는 선택 사항이며 NULL일 수 있습니다.

반환 값

없음

설명

드라이버는 WdfDmaTransactionAllocateResources 또는 WdfDmaTransactionExecute를 호출하기 전에 WdfDmaTransactionGetTransferInfo를 호출할 수 있습니다.

DMA 버전 3을 사용하는 경우 이 메서드는 필요한 지도 레지스터 수의 정확한 수를 반환합니다. 이전 DMA 버전을 사용하는 경우 이 메서드는 각 페이지에 지도 레지스터가 필요하다고 가정합니다.

요구 사항

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

추가 정보

WdfDmaTransactionAllocateResources

WdfDmaTransactionExecute