PBUILD_MDL_FROM_SCATTER_GATHER_LIST 콜백 함수(wdm.h)

아티클
02/27/2024

BuildMdlFromScatterGatherList 루틴은 시스템에서 할당한 분산/수집 목록에서 MDL을 빌드합니다.

이 루틴은 시스템 사용을 위해 예약되어 있습니다.

구문

PBUILD_MDL_FROM_SCATTER_GATHER_LIST PbuildMdlFromScatterGatherList;

NTSTATUS PbuildMdlFromScatterGatherList(
  [in]  PDMA_ADAPTER DmaAdapter,
  [in]  PSCATTER_GATHER_LIST ScatterGather,
  [in]  PMDL OriginalMdl,
  [out] PMDL *TargetMdl
)
{...}

매개 변수

[in] DmaAdapter

버스 master 어댑터 또는 DMA 컨트롤러를 나타내는 IoGetDmaAdapter에서 반환된 DMA_ADAPTER 구조체에 대한 포인터입니다.

[in] ScatterGather

드라이버의 AdapterListControl 루틴에 전달된 SCATTER_GATHER_LIST 구조체에 대한 포인터입니다.

[in] OriginalMdl

드라이버가 분산/수집 목록을 작성하는 데 사용한 원래 MDL에 대한 포인터입니다.

[out] TargetMdl

루틴이 산점/수집 목록에 설명된 버퍼를 보유하기 위해 만든 MDL을 반환하는 데 사용하는 변수에 대한 포인터입니다. 반환된 값은 OriginalMdl과 같을 수 있습니다.

반환 값

BuildMdlFromScatterGatherList는 다음 상태 코드 중 하나를 반환합니다.

반환 코드	설명
STATUS_SUCCESS	작업에 성공했습니다.
STATUS_INVALID_PARAMETER	OriginalMdl 매개 변수는 NULL입니다.
STATUS_INSUFFICIENT_RESOURCES	새 MDL을 할당하는 데 사용할 수 있는 메모리가 부족합니다.
STATUS_NONE_MAPPED	시스템에서 분산/수집 목록의 메모리 위치에 대한 새 MDL을 이미 만들었습니다. (루틴이 동일한 분산/수집 목록에서 두 번 호출되는 경우에만 발생합니다.)

설명

BuildMdlFromScatterGatherList 는 이름으로 직접 호출할 수 있는 시스템 루틴이 아닙니다. 이 루틴은 DMA_OPERATIONS 구조에서 반환된 주소의 포인터로만 호출할 수 있습니다. 드라이버는 DeviceDescription 매개 변수의 Version 멤버가 DEVICE_DESCRIPTION_VERSION2 설정된 IoGetDmaAdapter를 호출하여 이 루틴의 주소를 가져옵니다. IoGetDmaAdapter가 NULL을 반환하는 경우 플랫폼에서 루틴을 사용할 수 없습니다.

드라이버가 디바이스에 쓸 분산/수집 목록을 만들 때 시스템은 기록할 데이터의 복사본을 만들고 해당 복사본을 사용하여 DMA 작업을 수행할 수 있습니다. 이 루틴을 사용하여 해당 위치가 복사본인지 여부에 관계없이 분산/수집 목록의 메모리 위치에 액세스합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Windows XP 이상 버전의 Windows에서 사용할 수 있습니다.
대상 플랫폼	데스크톱
머리글	wdm.h(Wdm.h 포함)
IRQL	<= DISPATCH_LEVEL
DDI 규정 준수 규칙	IrqlDispatch(wdm)