PMAP_TRANSFER 콜백 함수(wdm.h)

아티클
02/27/2024

MapTransfer 루틴은 어댑터 개체에 대한 맵 레지스터를 설정하여 잠긴 버퍼에서 DMA 전송을 매핑합니다.

구문

PMAP_TRANSFER PmapTransfer;

PHYSICAL_ADDRESS PmapTransfer(
  [in]      PDMA_ADAPTER DmaAdapter,
  [in]      PMDL Mdl,
  [in]      PVOID MapRegisterBase,
  [in]      PVOID CurrentVa,
  [in, out] PULONG Length,
  [in]      BOOLEAN WriteToDevice
)
{...}

매개 변수

[in] DmaAdapter

IoGetDmaAdapter에서 반환되고 현재 IRP의 전송 요청에 대해 AllocateAdapterChannel에 이전에 전달된 DMA 어댑터 개체에 대한 포인터입니다.

[in] Mdl

다음 중 하나에 대한 포인터: 현재 IRP의 MdlAddress 에서 버퍼를 설명하는 MDL 또는 종속 디바이스의 드라이버가 설정한 공통 버퍼를 설명하는 MDL(자동 초기화 모드).

[in] MapRegisterBase

DMA 작업에 할당된 맵 레지스터를 지정합니다. 시스템은 이 값을 드라이버의 AdapterControl 루틴에 전달합니다.

[in] CurrentVa

DMA 전송 작업을 위해 전송할 데이터의 현재 가상 주소에 대한 포인터입니다.

[in, out] Length

매핑할 길이(바이트)를 지정합니다. 드라이버가 IoGetDmaAdapter를 호출할 때 분산/수집 지원이 있는 버스 master 표시한 경우 MapTransfer에서 반환되는 Length 값은 매핑된 바이트 수를 나타냅니다. 그렇지 않으면 Length 의 입력 및 출력 값이 동일합니다.

[in] WriteToDevice

전송 작업의 방향을 나타냅니다. 잠긴 버퍼에서 디바이스로 전송하는 경우 TRUE 입니다.

반환 값

MapTransfer는 버스 master 어댑터의 드라이버가 사용할 수 있는 매핑된 지역의 논리적 주소를 반환합니다. 시스템 DMA 컨트롤러를 사용하는 디바이스의 드라이버는 이 값을 사용할 수 없으며 무시해야 합니다.

설명

MapTransfer는 이름으로 직접 호출할 수 있는 시스템 루틴이 아닙니다. 이 루틴은 DMA_OPERATIONS 구조에서 반환된 주소의 포인터로만 호출할 수 있습니다. 드라이버는 IoGetDmaAdapter를 호출하여 이 루틴의 주소를 가져옵니다.

DmaAdapter는 드라이버가 AllocateAdapterChannel을 이전에 호출한 결과로 이미 할당되어 있어야 합니다.

설정할 수 있는 맵 레지스터 수는 드라이버가 IoGetDmaAdapter를 호출할 때 반환되는 최대값을 초과할 수 없습니다.

드라이버는 MmGetMdlVirtualAddress를 호출하여 패킷 기반 DMA 전송의 시작에 대한 초기 CurrentVa를 가져올 수 있습니다. 그러나 반환되는 값은 유효한 가상 주소가 아닌 Mdl에 대한 인덱스입니다. 드라이버가 큰 전송 요청을 둘 이상의 DMA 작업으로 분할해야 하는 경우 각 DMA 작업에 대해 CurrentVa 및 Length 를 업데이트해야 합니다.

분산/수집 지원이 있는 버스 master 디바이스의 드라이버는 반환된 논리 주소와 업데이트된 Length 값을 사용하여 분산/수집 목록을 작성할 수 있으며, 전송 작업에 사용 가능한 모든 지도 레지스터를 사용할 때까지 MapTransfer를 반복적으로 호출합니다. 그러나 이러한 드라이버는 GetScatterGatherList 루틴을 더 간단하게 사용할 수 있습니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows 2000부터 사용할 수 있습니다.
대상 플랫폼	데스크톱
헤더	wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	IrqlDispatch(wdm)