WdfDmaTransactionInitializeUsingRequest 함수(wdfdmatransaction.h)
[KMDF에만 적용]
WdfDmaTransactionInitializeUsingRequest 메서드는 지정된 I/O 요청의 매개 변수를 사용하여 지정된 DMA 트랜잭션을 초기화합니다.
구문
NTSTATUS WdfDmaTransactionInitializeUsingRequest(
[in] WDFDMATRANSACTION DmaTransaction,
[in] WDFREQUEST Request,
[in] PFN_WDF_PROGRAM_DMA EvtProgramDmaFunction,
[in] WDF_DMA_DIRECTION DmaDirection
);
매개 변수
[in] DmaTransaction
드라이버가 WdfDmaTransactionCreate에 대한 이전 호출에서 가져온 DMA 트랜잭션 개체에 대한 핸들입니다.
[in] Request
프레임워크 요청 개체에 대한 핸들입니다.
[in] EvtProgramDmaFunction
드라이버의 EvtProgramDma 이벤트 콜백 함수에 대한 포인터입니다.
[in] DmaDirection
DMA 전송 방향을 지정하는 WDF_DMA_DIRECTION 형식의 값입니다.
반환 값
WdfDmaTransactionInitializeUsingRequest 는 작업이 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 메서드는 WdfDmaTransactionInitialize의 반환 값 섹션에 설명된 값 중 하나를 반환할 수 있습니다.
이 메서드는 다른 NTSTATUS 값을 반환할 수도 있습니다.
드라이버가 잘못된 개체 핸들을 제공하는 경우 버그 검사 발생합니다.
설명
WdfDmaTransactionInitializeUsingRequest 메서드는 트랜잭션의 분산/수집 목록 설정과 같은 초기화 작업을 수행하여 실행을 위해 DMA 작업을 준비합니다. 드라이버가 WdfDmaTransactionInitializeUsingRequest를 호출한 후 드라이버는 WdfDmaTransactionExecute를 호출해야 합니다.
드라이버는 WdfRequestGetParameters 를 호출하여 요청의 형식을 가져올 수 있습니다. 드라이버가 DmaDirection 매개 변수에 대해 지정하는 값은 다음과 같이 요청 형식에 적합해야 합니다.
- DmaDirection 값은 다음과 같은 경우 WdfDmaDirectionReadFromDevice여야 합니다.
- 요청 유형이 WdfRequestTypeRead입니다.
- 요청 유형은 WdfRequestTypeDeviceControl 또는 WdfRequestTypeDeviceControlInternal 이고 I/O 컨트롤 코드는 전송 형식을 METHOD_OUT_DIRECT
-
DmaDirection 값은 다음과 같은 경우 WdfDmaDirectionWriteToDevice여야 합니다.
- 요청 유형이 WdfRequestTypeWrite입니다.
- 요청 유형은 WdfRequestTypeDeviceControl 또는 WdfRequestTypeDeviceControlInternal 이고 I/O 컨트롤 코드는 전송 형식을 METHOD_IN_DIRECT
프레임워크 기반 드라이버는 일반적으로 I/O 큐 이벤트 콜백 함수 내에서 WdfDmaTransactionInitializeUsingRequest를 호출합니다.
프레임워크 요청 개체에 포함된 정보를 기반으로 하는 DMA 트랜잭션을 만드는 경우 드라이버는 WdfDmaTransactionInitializeUsingRequest 를 호출해야 합니다. 요청 개체를 기반으로 하지 않는 DMA 트랜잭션을 만드는 경우 WdfDmaTransactionInitialize 를 사용합니다.
요청 개체가 설명하는 버퍼가 드라이버가 WdfDmaEnablerCreate 또는 WdfDmaTransactionSetMaximumLength를 호출할 때 지정한 최대 전송 길이보다 큰 경우 프레임워크는 트랜잭션을 여러 전송으로 중단 합니다.
DMA 트랜잭션에 대한 자세한 내용은 DMA 트랜잭션 만들기 및 초기화를 참조하세요.
예제
WdfDmaTransactionInitializeUsingRequest를 사용하는 코드 예제는 WdfDmaTransactionExecute를 참조하세요.
요구 사항
요구 사항 | 값 |
---|---|
대상 플랫폼 | 유니버설 |
최소 KMDF 버전 | 1.0 |
머리글 | wdfdmatransaction.h(Wdf.h 포함) |
라이브러리 | Wdf01000.sys(프레임워크 라이브러리 버전 관리 참조) |
IRQL | <=DISPATCH_LEVEL |
DDI 규정 준수 규칙 | DeferredRequestCompleted(kmdf), DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), RequestCompleted(kmdf), RequestCompletedLocal(kmdf) |