WdfDmaTransactionInitializeUsingRequest 함수(wdfdmatransaction.h)

아티클
08/08/2023

[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 컨트롤 코드의 전송 형식에 대한 자세한 내용은 I/O 제어 코드 정의를 참조하세요.

프레임워크 기반 드라이버는 일반적으로 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)