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) |