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) |