MmMapLockedPages 함수(wdm.h)

  • 아티클

MmMapLockedPages 루틴은 Windows 2000 이상 버전의 Windows 및 Windows Me에서는 사용되지 않습니다. Windows 98에서 실행해야 하는 WDM 드라이버에 대해서만 지원됩니다. 그렇지 않으면 MmMapLockedPagesSpecifyCache를 사용합니다.

MmMapLockedPages 루틴은 지정된 MDL에서 설명하는 실제 페이지를 매핑합니다.

구문

PVOID MmMapLockedPages(
  [in] PMDL                                                                          MemoryDescriptorList,
  [in] __drv_strictType(KPROCESSOR_MODE / enum _MODE,__drv_typeConst)KPROCESSOR_MODE AccessMode
);

매개 변수

[in] MemoryDescriptorList

MmProbeAndLockPages에서 업데이트한 MDL에 대한 포인터입니다.

[in] AccessMode

MDL을 매핑할 액세스 모드( KernelMode 또는 UserMode)를 지정합니다. 거의 모든 드라이버는 KernelMode를 사용해야 합니다.

반환 값

MmMapLockedPages는 매핑된 페이지의 시작 주소를 반환합니다. (4.0 SP4(서비스 팩 4)를 Windows NT 이전의 NT 기반 운영 체제의 경우 MmMapLockedPages는 매핑된 페이지의 첫 번째 페이지의 시작 주소를 반환합니다.

설명

MmUnmapLockedPages를 사용하여 MmMapLockedPages에 의해 매핑된 실제 페이지의 매핑을 해제합니다.

AccessMode가 KernelMode이고 MmMapLockedPages가 지정된 페이지를 매핑할 수 없는 경우 시스템에서 버그 검사 발급합니다. (이러한 이유로 드라이버는 사용 가능한 경우 MmMapLockedPagesSpecifyCache를 사용해야 합니다. 해당 루틴은 버그 검사 발생시키는 대신 실패 시 NULL을 반환합니다.) AccessMode가 UserMode이고 지정된 페이지를 매핑할 수 없는 경우 루틴에서 예외가 발생합니다. UserMode를 지정하는 호출자는 Try/except 블록에서 MmMapLockedPages에 대한 호출을 래핑해야 합니다. 자세한 내용은 예외 처리를 참조하세요.

AccessMode가 KernelMode인 경우 MmMapLockedPages의 호출자는 IRQL <= DISPATCH_LEVEL 실행되어야 합니다. 그렇지 않으면 호출자가 IRQL <= APC_LEVEL 실행 중이어야 합니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 2000 이상 버전의 Windows 및 Windows Me에서는 사용되지 않습니다. 이 루틴은 Windows 98에서 실행해야 하는 WDM 드라이버에 대해서만 지원됩니다. 그렇지 않으면 MmMapLockedPagesSpecifyCache를 사용합니다.
대상 플랫폼 유니버설
헤더 wdm.h(Wdm.h, Ntddk.h, Ntifs.h 포함)
라이브러리 NtosKrnl.lib
DLL NtosKrnl.exe
IRQL 설명 섹션을 참조하십시오.
DDI 규정 준수 규칙 HwStorPortProhibitedDDIs(storport)

추가 정보

MmGetSystemAddressForMdl

MmGetSystemAddressForMdlSafe

MmMapLockedPagesSpecifyCache

MmProbeAndLockPages

MmUnmapLockedPages