mmfuncs.h File Reference

Go to the source code of this file.

Macros
#define	ALIGN_DOWN_BY(size, align)   ((ULONG_PTR)(size) & ~((ULONG_PTR)(align) - 1))
#define	ALIGN_UP_BY(size, align)   (ALIGN_DOWN_BY(((ULONG_PTR)(size) + align - 1), align))
#define	ALIGN_DOWN_POINTER_BY(ptr, align)   ((PVOID)ALIGN_DOWN_BY(ptr, align))
#define	ALIGN_UP_POINTER_BY(ptr, align)   ((PVOID)ALIGN_UP_BY(ptr, align))
#define	ALIGN_DOWN(size, type)   ALIGN_DOWN_BY(size, sizeof(type))
#define	ALIGN_UP(size, type)   ALIGN_UP_BY(size, sizeof(type))
#define	ALIGN_DOWN_POINTER(ptr, type)   ALIGN_DOWN_POINTER_BY(ptr, sizeof(type))
#define	ALIGN_UP_POINTER(ptr, type)   ALIGN_UP_POINTER_BY(ptr, sizeof(type))
#define	FIELD_OFFSET(type, field)   ((ULONG)&(((type *)0)->field))
#define	FIELD_SIZE(type, field)   (sizeof(((type *)0)->field))
#define	POOL_TAGGING   1
#define	IF_DEBUG   if (FALSE)
#define	BYTE_OFFSET(Va)   ((ULONG) ((ULONG_PTR) (Va) & (PAGE_SIZE - 1)))
#define	BYTES_TO_PAGES(Size)   (((Size) >> PAGE_SHIFT) + (((Size) & (PAGE_SIZE - 1)) != 0))
#define	PAGE_ALIGN(Va)   ((PVOID) ((ULONG_PTR)(Va) & ~(PAGE_SIZE - 1)))
#define	ROUND_TO_PAGES(Size)   (((ULONG_PTR) (Size) + PAGE_SIZE - 1) & ~(PAGE_SIZE - 1))
#define	ADDRESS_AND_SIZE_TO_SPAN_PAGES(_Va, _Size)
#define	COMPUTE_PAGES_SPANNED(Va, Size)   ADDRESS_AND_SIZE_TO_SPAN_PAGES(Va,Size)
#define	MmGetMdlByteCount(_Mdl)   ((_Mdl)->ByteCount)
#define	MmGetMdlByteOffset(_Mdl)   ((_Mdl)->ByteOffset)
#define	MmGetMdlBaseVa(Mdl)   ((Mdl)->StartVa)
#define	MmGetMdlPfnArray(_Mdl)   ((PPFN_NUMBER) ((_Mdl) + 1))
#define	MmGetMdlVirtualAddress(_Mdl)   ((PVOID) ((PCHAR) ((_Mdl)->StartVa) + (_Mdl)->ByteOffset))
#define	MmGetProcedureAddress(Address)   (Address)
#define	MmLockPagableCodeSection(Address)   MmLockPagableDataSection(Address)
#define	MmGetSystemAddressForMdl(Mdl)
#define	MmGetSystemAddressForMdlSafe(_Mdl, _Priority)
#define	MmInitializeMdl(_MemoryDescriptorList, _BaseVa, _Length)
#define	MmPrepareMdlForReuse(_Mdl)

Functions
	$if (_WDMDDK_)$endif(_WDMDDK_) $if(_NTIFS_) FORCEINLINE ULONG HEAP_MAKE_TAG_FLAGS(_In_ ULONG TagBase
	$endif (_NTIFS_) $if(_WDMDDK_) _Must_inspect_result_ _IRQL_requires_max_(DISPATCH_LEVEL) _When_(return!
	_Post_writable_byte_size_ (NumberOfBytes)) NTKERNELAPI PVOID NTAPI MmAllocateContiguousMemory(_In_ SIZE_T NumberOfBytes
_Must_inspect_result_	_IRQL_requires_max_ (DISPATCH_LEVEL) _When_(return!
NTKERNELAPI PMDL NTAPI	MmCreateMdl (_Out_writes_bytes_opt_(sizeof(MDL)+(sizeof(PFN_NUMBER)*ADDRESS_AND_SIZE_TO_SPAN_PAGES(Base, Length))) PMDL MemoryDescriptorList, _In_reads_bytes_opt_(Length) PVOID Base, _In_ SIZE_T Length)
	_IRQL_requires_max_ (PASSIVE_LEVEL) NTKERNELAPI PVOID NTAPI MmGetSystemRoutineAddress(_In_ PUNICODE_STRING SystemRoutineName)
NTKERNELAPI LOGICAL NTAPI	MmIsDriverVerifying (_In_ struct _DRIVER_OBJECT *DriverObject)
_Must_inspect_result_	_IRQL_requires_max_ (APC_LEVEL) NTKERNELAPI PVOID NTAPI MmLockPagableDataSection(_In_ PVOID AddressWithinSection)
_Must_inspect_result_	_When_ (AccessMode==KernelMode, _IRQL_requires_max_(DISPATCH_LEVEL)) _When_(AccessMode
_Must_inspect_result_ _Maybe_raises_SEH_exception_ _In_	__drv_strictType (KPROCESSOR_MODE/enum _MODE, __drv_typeConst) KPROCESSOR_MODE AccessMode)
	_Post_writable_byte_size_ (MemoryDescriptorList->ByteCount) _When_(AccessMode
NTKERNELAPI MM_SYSTEMSIZE NTAPI	MmQuerySystemSize (VOID)
NTKERNELAPI SIZE_T NTAPI	MmSizeOfMdl (_In_reads_bytes_opt_(Length) PVOID Base, _In_ SIZE_T Length)
	$endif (_WDMDDK_) $if(_NTDDK_) _IRQL_requires_max_(PASSIVE_LEVEL) NTKERNELAPI PPHYSICAL_MEMORY_RANGE NTAPI MmGetPhysicalMemoryRanges(VOID)
NTKERNELAPI PHYSICAL_ADDRESS NTAPI	MmGetPhysicalAddress (_In_ PVOID BaseAddress)
NTKERNELAPI BOOLEAN NTAPI	MmIsNonPagedSystemAddressValid (_In_ PVOID VirtualAddress)
NTKERNELAPI PVOID NTAPI	MmGetVirtualForPhysical (_In_ PHYSICAL_ADDRESS PhysicalAddress)
NTKERNELAPI BOOLEAN NTAPI	MmIsThisAnNtAsSystem (VOID)
_Must_inspect_result_ _In_	__in_data_source (USER_MODE) SIZE_T Size
	$endif (_NTDDK_) $if(_NTIFS_) NTKERNELAPI BOOLEAN NTAPI MmIsRecursiveIoFault(VOID)
_Must_inspect_result_	_Out_writes_bytes_opt_ (NumberOfBytes)) NTKERNELAPI PVOID NTAPI MmAllocateMappingAddress(_In_ SIZE_T NumberOfBytes
	_In_reads_ (NumberOfLists) PREAD_LIST *ReadLists)
_Must_inspect_result_ _At_ *	BaseAddress (Mem)) __kernel_entryNTSYSCALLAPINTSTATUSNTAPINtAllocateVirtualMemory(_In_ HANDLE ProcessHandle, _Inout_ _Outptr_result_buffer_(*RegionSize) PVOID *BaseAddress, _In_ ULONG_PTR ZeroBits, _Inout_ PSIZE_T RegionSize, _In_ ULONG AllocationType, _In_ ULONG Protect
__kernel_entry _Inout_	__drv_freesMem (Mem) PVOID *BaseAddress

Variables
_In_ ULONG	Tag
_In_ PHYSICAL_ADDRESS	HighestAcceptableAddress
_Must_inspect_result_ _In_ PHYSICAL_ADDRESS	LowestAcceptableAddress
_Must_inspect_result_ _In_ PHYSICAL_ADDRESS _In_ PHYSICAL_ADDRESS _In_opt_ PHYSICAL_ADDRESS	BoundaryAddressMultiple
_Must_inspect_result_ _In_ PHYSICAL_ADDRESS _In_ PHYSICAL_ADDRESS _In_opt_ PHYSICAL_ADDRESS _In_ MEMORY_CACHING_TYPE	CacheType
_Must_inspect_result_ _In_ PHYSICAL_ADDRESS	HighAddress
_Must_inspect_result_ _In_ PHYSICAL_ADDRESS _In_ PHYSICAL_ADDRESS	SkipBytes
_Must_inspect_result_ _In_ PHYSICAL_ADDRESS _In_ PHYSICAL_ADDRESS _In_ SIZE_T	TotalBytes
_In_ SIZE_T	NumberOfBytes
_In_ PEPROCESS	Process
_In_ PEPROCESS _In_ KPROCESSOR_MODE	AccessMode
_In_ PEPROCESS _In_ KPROCESSOR_MODE _In_ LOCK_OPERATION	Operation
_Inout_ PMDL	MemoryDescriptorList
_Must_inspect_result_ _In_ PHYSICAL_ADDRESS _In_ PHYSICAL_ADDRESS _In_opt_ PHYSICAL_ADDRESS _In_ MEMORY_CACHING_TYPE _In_ NODE_REQUIREMENT	PreferredNode
_Must_inspect_result_ _In_ SIZE_T _In_ PVOID	PageAddress
_Must_inspect_result_ _Outptr_result_bytebuffer_ ViewSize PVOID *	MappedBase
_Must_inspect_result_ _Outptr_result_bytebuffer_ ViewSize PVOID _Inout_ PSIZE_T	ViewSize
_Must_inspect_result_ _In_ _In_ ULONG	ProbeMode
_In_ BOOLEAN	DelayClose
_In_ MMFLUSH_TYPE	FlushType
_In_opt_ PLARGE_INTEGER	NewFileSize
_In_ SIZE_T	Length
_Must_inspect_result_ _In_ ULONG	PoolTag
_Must_inspect_result_ _In_ ULONG	NewProtect
_In_ ULONG	ThunkBufferSize
_In_ PHYSICAL_ADDRESS _In_ PHYSICAL_ADDRESS _In_ SIZE_T _In_ MEMORY_CACHING_TYPE _In_ ULONG	Flags
_Inout_ PSIZE_T _In_opt_ PMDLX	NewMdl
_Inout_ PSIZE_T _In_opt_ PMDLX _In_ MM_ROTATE_DIRECTION	Direction
_Inout_ PSIZE_T _In_opt_ PMDLX _In_ MM_ROTATE_DIRECTION _In_ PMM_ROTATE_COPY_CALLBACK_FUNCTION	CopyFunction
_Inout_ PSIZE_T _In_opt_ PMDLX _In_ MM_ROTATE_DIRECTION _In_ PMM_ROTATE_COPY_CALLBACK_FUNCTION _In_opt_ PVOID	Context
__kernel_entry _Inout_ _Inout_ PSIZE_T	RegionSize
__kernel_entry _Inout_ _Inout_ PSIZE_T _In_ ULONG	FreeType

Macro Definition Documentation

#define ADDRESS_AND_SIZE_TO_SPAN_PAGES	(		_Va,
			_Size
	)

Value:

((ULONG) ((((ULONG_PTR) (_Va) & (PAGE_SIZE - 1)) \
    + (_Size) + (PAGE_SIZE - 1)) >> PAGE_SHIFT))

Referenced by CUSBRequest::BuildIsochronousEndpoint(), CdRomStartIo(), CdRomSwitchModeCompletion(), EngSecureMemForRead(), FatBuildZeroMdl(), FsRtlCopyRead(), FsRtlCopyRead2(), GdiPoolAllocate(), HalpAcpiTableCacheInit(), IoAllocateMdl(), IoBuildPartialMdl(), MiAllocatePagesForMdl(), MiMapLockedPagesInUserSpace(), MiUnmapLockedPagesInUserSpace(), MmAllocateNonCachedMemory(), MmBuildMdlForNonPagedPool(), MmFreePagesFromMdl(), MmMapIoSpace(), MmMapLockedPagesSpecifyCache(), MmProbeAndLockPages(), MmSelectMappingAddress(), MmSizeOfMdl(), MmUnlockPages(), MmUnmapIoSpace(), MmUnmapLockedPages(), NDIS_BUFFER_TO_SPAN_PAGES(), PcMemGetMemoryMap(), RamdiskMapPages(), RamdiskUnmapPages(), ReserveMemory(), ScsiCdRomStartIo(), ScsiClassReadWrite(), ScsiPortStartIo(), SetMemory(), TestMmAllocatePagesForMdl(), USBPORT_AllocateTransfer(), and USBPORT_FlushMapTransfers().

#define ALIGN_DOWN	(		size,
			type
	)		ALIGN_DOWN_BY(size, sizeof(type))

#define ALIGN_DOWN_BY	(		size,
			align
	)		((ULONG_PTR)(size) & ~((ULONG_PTR)(align) - 1))

#define ALIGN_DOWN_POINTER	(		ptr,
			type
	)		ALIGN_DOWN_POINTER_BY(ptr, sizeof(type))

#define ALIGN_DOWN_POINTER_BY	(		ptr,
			align
	)		((PVOID)ALIGN_DOWN_BY(ptr, align))

#define ALIGN_UP	(		size,
			type
	)		ALIGN_UP_BY(size, sizeof(type))

#define ALIGN_UP_BY	(		size,
			align
	)		(ALIGN_DOWN_BY(((ULONG_PTR)(size) + align - 1), align))

#define ALIGN_UP_POINTER	(		ptr,
			type
	)		ALIGN_UP_POINTER_BY(ptr, sizeof(type))

#define ALIGN_UP_POINTER_BY	(		ptr,
			align
	)		((PVOID)ALIGN_UP_BY(ptr, align))

#define BYTE_OFFSET

(

Va

)

((ULONG) ((ULONG_PTR) (Va) & (PAGE_SIZE - 1)))

Referenced by CUSBRequest::BuildIsochronousEndpoint(), CUSBRequest::BuildTransferDescriptorChain(), HalpCopyBufferMap(), HalpMapPhysicalMemory64Vista(), CUSBRequest::InitDescriptor(), IoBuildPartialMdl(), IoFlushAdapterBuffers(), IoMapTransfer(), MiAllocatePagesForMdl(), MiDbgTranslatePhysicalAddress(), MiMapLockedPagesInUserSpace(), MmAllocateContiguousMemorySpecifyCache(), MmDbgCopyMemory(), MmDefpTranslateVirtualAddress(), MmGetPhysicalAddress(), MmMapIoSpace(), MmSelectMappingAddress(), RamdiskMapPages(), and RamdiskUnmapPages().

#define BYTES_TO_PAGES

(

Size

)

(((Size) >> PAGE_SHIFT) + (((Size) & (PAGE_SIZE - 1)) != 0))

Referenced by CcReadVirtualAddress(), CcRosMapVacbInKernelSpace(), CreateDMA(), CustomBaseAllocation(), ExAllocatePoolWithTag(), HalGetAdapter(), HalpAcpiCopyBiosTable(), HalpAcpiFindRsdtPhase0(), HalpAcpiGetTable(), HalpAcpiGetTableFromBios(), HalpGrowMapBuffers(), IoMapTransfer(), IoSynchronousPageWrite(), MiAllocateContiguousMemory(), MiAllocatePoolPages(), MiBuildPagedPool(), MiCalculatePageCommitment(), MiCreatePebOrTeb(), MiDereferenceSession(), MiFindEmptyAddressRangeInTree(), MiInitializeNonPagedPool(), MiLocateKernelSections(), MiMapViewInSystemSpace(), MiMapViewOfDataSection(), MiWriteProtectSystemImage(), MmAllocateNonCachedMemory(), MmCreateKernelStack(), MmDeleteKernelStack(), MmFreeNonCachedMemory(), MmFwGetMemoryMap(), ReadWritePassive(), and ScsiPortInitialize().

#define COMPUTE_PAGES_SPANNED	(		Va,
			Size
	)		ADDRESS_AND_SIZE_TO_SPAN_PAGES(Va,Size)

#define FIELD_OFFSET	(		type,
			field
	)		((ULONG)&(((type *)0)->field))

#define FIELD_SIZE	(		type,
			field
	)		(sizeof(((type *)0)->field))

#define IF_DEBUG   if (FALSE)

#define MmGetMdlBaseVa

(

Mdl

)

((Mdl)->StartVa)

#define MmGetMdlByteCount

(

_Mdl

)

((_Mdl)->ByteCount)

Referenced by CUSBRequest::BuildIsochronousEndpoint(), CdRomDeviceControlDispatch(), DispTdiQueryInformation(), DispTdiQueryInformationEx(), FreeBT_DispatchRead(), FreeBT_DispatchWrite(), IoPageRead(), IoSynchronousPageWrite(), LockRequest(), MiMapLockedPagesInUserSpace(), MiUnmapLockedPagesInUserSpace(), NDIS_BUFFER_TO_SPAN_PAGES(), NdisBufferLength(), NdisGetFirstBufferFromPacket(), NdisGetFirstBufferFromPacketSafe(), NdisMCompleteBufferPhysicalMapping(), NdisMStartBufferPhysicalMapping(), NdisQueryBuffer(), NdisQueryBufferOffset(), NdisQueryBufferSafe(), TestMmAllocatePagesForMdl(), UnlockRequest(), USBSTOR_SendRequest(), VideoPortStartDma(), and XNdisGetFirstBufferFromPacket().

#define MmGetMdlByteOffset

(

_Mdl

)

((_Mdl)->ByteOffset)

Referenced by MiMapLockedPagesInUserSpace(), and NdisQueryBufferOffset().

#define MmGetMdlPfnArray

(

_Mdl

)

((PPFN_NUMBER) ((_Mdl) + 1))

Referenced by FatBuildZeroMdl(), HalInitializeBios(), IoFlushAdapterBuffers(), IoMapTransfer(), MiMapLockedPagesInUserSpace(), MiUnmapLockedPagesInUserSpace(), MmUnmapLockedPages(), and TestMmAllocatePagesForMdl().

#define MmGetMdlVirtualAddress

(

_Mdl

)

((PVOID) ((PCHAR) ((_Mdl)->StartVa) + (_Mdl)->ByteOffset))

Referenced by _Requires_lock_held_(), CUSBRequest::BuildBulkInterruptTransferDescriptor(), CUSBRequest::BuildControlTransferDescriptor(), CUSBRequest::BuildControlTransferQueueHead(), CUSBRequest::BuildIsochronousEndpoint(), CdRomStartIo(), CdRomSwitchModeCompletion(), ClasspBuildRequestEx(), ClassSendSrbAsynchronous(), DiskInfoExceptionComplete(), FreeBT_DispatchRead(), FreeBT_DispatchWrite(), HalpCopyBufferMap(), IoPageRead(), IoSynchronousPageWrite(), MiUnmapLockedPagesInUserSpace(), NDIS_BUFFER_TO_SPAN_PAGES(), NdisCopyBuffer(), NdisMCompleteBufferPhysicalMapping(), NdisMCompleteDmaTransfer(), NdisMSetupDmaTransfer(), NdisMStartBufferPhysicalMapping(), prepare_raid5_write(), prepare_raid6_write(), ProSend(), ReadWritePassive(), RetryRequest(), ScsiCdRomStartIo(), ScsiClassBuildRequest(), ScsiClassReadWrite(), ScsiClassSendSrbAsynchronous(), ScsiClassSplitRequest(), ScsiPortStartIo(), ServiceTransferRequest(), SoundProgramDMA(), SpiAdapterControl(), SpiProcessCompletedRequest(), TestMmAllocatePagesForMdl(), USBPORT_AllocateTransfer(), USBPORT_CompleteTransfer(), USBPORT_FlushMapTransfers(), USBPORT_MapTransfer(), USBSTOR_SendRequest(), VfatReadDiskPartial(), VfatWriteDiskPartial(), WdmAudReadWrite(), write_data(), and XNdisGetFirstBufferFromPacket().

#define MmGetProcedureAddress

(

Address

)

(Address)

#define MmGetSystemAddressForMdl

(

Mdl

)

Value:

(((Mdl)->MdlFlags & (MDL_MAPPED_TO_SYSTEM_VA | \
    MDL_SOURCE_IS_NONPAGED_POOL)) ? \
      ((Mdl)->MappedSystemVa) : \
      (MmMapLockedPages((Mdl), KernelMode)))

Referenced by CdfsQueryDirectory(), CdfsRead(), DispTdiQueryInformation(), Ext2GetUserBuffer(), Ext2IsVolumeDirty(), FFSGetUserBuffer(), FsdRead(), FsRtlCancelNotify(), FsRtlNotifyCompleteIrp(), FsRtlNotifyFilterReportChange(), LockRequest(), MmGetSystemAddressForMdlPrettySafe(), NdisBufferVirtualAddress(), NdisGetFirstBufferFromPacket(), NdisIDeviceIoControl(), NdisQueryBuffer(), RfsdGetUserBuffer(), ScreenDeviceControl(), ScrIoControl(), ScsiPortStartIo(), UDFIsVolumeDirty(), and VideoPortStartDma().

#define MmGetSystemAddressForMdlSafe	(		_Mdl,
			_Priority
	)

Value:

(((_Mdl)->MdlFlags & (MDL_MAPPED_TO_SYSTEM_VA \
    | MDL_SOURCE_IS_NONPAGED_POOL)) ? \
    (_Mdl)->MappedSystemVa : \
    (PVOID) MmMapLockedPagesSpecifyCache((_Mdl), \
      KernelMode, MmCached, NULL, FALSE, (_Priority)))

Referenced by _Requires_lock_held_(), CUSBRequest::BuildBulkInterruptEndpoint(), CUSBRequest::BuildBulkInterruptTransferQueueHead(), CUSBRequest::BuildIsochronousEndpoint(), DriverIoControl(), ExLockUserBuffer(), Ext2GetUserBuffer(), FatIsVolumeDirty(), FatMapUserBuffer(), FFSGetUserBuffer(), FillEntries(), get_compression(), HackSecureVirtualMemory(), HalInitializeBios(), HalpCopyBufferMap(), HidClass_ReadCompleteIrp(), IKsPin_DispatchKsStream(), is_volume_dirty(), KsecDdDispatch(), LockRequest(), map_user_buffer(), MapAndLockUserBuffer(), MmGetSystemAddressForMdlPrettySafe(), MsfsRead(), MsfsWrite(), NdisGetFirstBufferFromPacketSafe(), NdisQueryBufferSafe(), NtfsGetUserBuffer(), prepare_raid5_write(), prepare_raid6_write(), read_data(), RfsdGetUserBuffer(), RxLowIoPopulateFsctlInfo(), RxMapSystemBuffer(), RxNewMapUserBuffer(), RxNotifyChangeDirectory(), SerialGetUserBuffers(), UDFGetCallersBuffer(), USBPORT_MapTransfer(), VfatGetUserBuffer(), vol_read(), vol_write(), and write_data().

#define MmInitializeMdl	(		_MemoryDescriptorList,
			_BaseVa,
			_Length
	)

Value:

{ \
  (_MemoryDescriptorList)->Next = (PMDL) NULL; \
  (_MemoryDescriptorList)->Size = (CSHORT) (sizeof(MDL) + \
    (sizeof(PFN_NUMBER) * ADDRESS_AND_SIZE_TO_SPAN_PAGES(_BaseVa, _Length))); \
  (_MemoryDescriptorList)->MdlFlags = 0; \
  (_MemoryDescriptorList)->StartVa = (PVOID) PAGE_ALIGN(_BaseVa); \
  (_MemoryDescriptorList)->ByteOffset = BYTE_OFFSET(_BaseVa); \
  (_MemoryDescriptorList)->ByteCount = (ULONG) _Length; \
}

Referenced by CcZeroData(), IoAllocateMdl(), MiDoMappedCopy(), MiReadFilePage(), MiReadPageFile(), MmCreateMdl(), and MmWriteToSwapPage().

#define MmLockPagableCodeSection

(

Address

)

MmLockPagableDataSection(Address)

Referenced by CdRomRemoveDevice(), and ScanForSpecial().

#define MmPrepareMdlForReuse

(

_Mdl

)

Value:

{ \
  if (((_Mdl)->MdlFlags & MDL_PARTIAL_HAS_BEEN_MAPPED) != 0) { \
    ASSERT(((_Mdl)->MdlFlags & MDL_PARTIAL) != 0); \
    MmUnmapLockedPages((_Mdl)->MappedSystemVa, (_Mdl)); \
  } else if (((_Mdl)->MdlFlags & MDL_PARTIAL) == 0) { \
    ASSERT(((_Mdl)->MdlFlags & MDL_MAPPED_TO_SYSTEM_VA) == 0); \
  } \
}

Referenced by FatPagingFileCompletionRoutineCatch(), and IoFreeMdl().

#define PAGE_ALIGN

(

Va

)

((PVOID) ((ULONG_PTR)(Va) & ~(PAGE_SIZE - 1)))

Referenced by BlpMmInitializeConstraints(), ExAllocatePoolWithQuotaTag(), ExAllocatePoolWithTag(), ExFreePoolWithTag(), ExpCheckPoolAllocation(), ExpCheckPoolBlocks(), ExpCheckPoolHeader(), Fast486ReadMemory(), GdiPoolAllocate(), ImgArchEfiStartBootApplication(), MiCheckForUserStackOverflow(), MiCheckVirtualAddress(), MiComputeNonPagedPoolVa(), MiDeletePte(), MiInitMachineDependent(), MiProtectVirtualMemory(), MiQueryMemoryBasicInformation(), MiSessionCommitPageTables(), MiSpecialPoolCheckPattern(), MmAccessFault(), MmCommitSessionMappedView(), MmFreeNonCachedMemory(), MmFreeSpecialPool(), MmProbeAndLockPages(), NtAllocateVirtualMemory(), NtFlushVirtualMemory(), NtFreeVirtualMemory(), and RtlpCaptureStackLimits().

#define POOL_TAGGING   1

#define ROUND_TO_PAGES

(

Size

)

(((ULONG_PTR) (Size) + PAGE_SIZE - 1) & ~(PAGE_SIZE - 1))

Referenced by _Requires_lock_held_(), BlImgAllocateImageBuffer(), BlImgUnallocateImageBuffer(), BlockIopAllocateAlignedBuffer(), ExAllocatePoolWithTag(), FsRecReadBlock(), CUSBRequest::InitDescriptor(), InitializePool(), MiCreatePebOrTeb(), MiEnablePagingOfDriver(), MiFindEmptyAddressRangeDownBasedTree(), MiFindEmptyAddressRangeDownTree(), MiInitializeSessionIds(), MiLoadImageSection(), MiReloadBootLoadedDrivers(), MmArmInitSystem(), MmDeleteTeb(), MmFreeDriverInitialization(), MmFwGetMemoryMap(), MmMapPhysicalAddress(), NtAllocateVirtualMemory(), SpiAllocateCommonBuffer(), and USBPORT_AllocateCommonBuffer().

Function Documentation

$endif

(

_NTIFS_

)

Definition at line 2594 of file iofuncs.h.

{
  ASSERT(Irp->CurrentLocation <= Irp->StackCount);
  Irp->CurrentLocation++;
#ifdef NONAMELESSUNION
  Irp->Tail.Overlay.s.u.CurrentStackLocation++;
#else
  Irp->Tail.Overlay.CurrentStackLocation++;
#endif
}

$endif

(

_WDMDDK_

)

Definition at line 202 of file ke.h.

{
    ULONGLONG Low;
    LONGLONG High;
} NEON128, *PNEON128;

$endif

(

_NTDDK_

)

Definition at line 2487 of file iofuncs.h.

{
    PriorityInfo->Size = sizeof(IO_PRIORITY_INFO);
    PriorityInfo->ThreadPriority = 0xffff;
    PriorityInfo->IoPriority = IoPriorityNormal;
    PriorityInfo->PagePriority = 0;
}

$if

(

_WDMDDK_

)

Kernel definitions for AMD64

Kernel definitions for ARM

Definition at line 1 of file ke.h.

{
    ULONG Dummy;
} KFLOATING_SAVE, *PKFLOATING_SAVE;

__kernel_entry _Inout_ __drv_freesMem

(

Mem

)

Definition at line 1315 of file exfuncs.h.

{
  Lookaside->L.TotalFrees++;
#ifdef NONAMELESSUNION
  if (ExQueryDepthSList(&Lookaside->L.u.ListHead) >= Lookaside->L.Depth) {
    Lookaside->L.u3.FreeMisses++;
    (Lookaside->L.u5.Free)(Entry);
  } else {
#if defined(_WIN2K_COMPAT_SLIST_USAGE) && defined(_X86_)
      ExInterlockedPushEntrySList(&Lookaside->L.u.ListHead,
                                  (PSLIST_ENTRY)Entry,
                                  &Lookaside->Lock__ObsoleteButDoNotDelete);
#else
      InterlockedPushEntrySList(&Lookaside->L.u.ListHead, (PSLIST_ENTRY)Entry);
#endif
   }
#else /* NONAMELESSUNION */
  if (ExQueryDepthSList(&Lookaside->L.ListHead) >= Lookaside->L.Depth) {
    Lookaside->L.FreeMisses++;
    (Lookaside->L.Free)(Entry);
  } else {
#if defined(_WIN2K_COMPAT_SLIST_USAGE) && defined(_X86_)
      ExInterlockedPushEntrySList(&Lookaside->L.ListHead,
                                  (PSLIST_ENTRY)Entry,
                                  &Lookaside->Lock__ObsoleteButDoNotDelete);
#else
      InterlockedPushEntrySList(&Lookaside->L.ListHead, (PSLIST_ENTRY)Entry);
#endif
   }
#endif /* NONAMELESSUNION */
}

_Must_inspect_result_ _Maybe_raises_SEH_exception_ _In_ __drv_strictType	(	KPROCESSOR_MODE/enum	_MODE,
		__drv_typeConst
	)

_Must_inspect_result_ _In_ __in_data_source

(

USER_MODE

)

_In_reads_

(

NumberOfLists

)

_Must_inspect_result_ _IRQL_requires_max_

(

DISPATCH_LEVEL

)

Definition at line 30 of file rmap.c.

{
    ExFreePoolWithTag(P, TAG_RMAP);
}

_IRQL_requires_max_

(

PASSIVE_LEVEL

)

Definition at line 64 of file Messaging.c.

{
    PFLT_SERVER_PORT_OBJECT PortObject;
    NTSTATUS Status;

    /* The caller must allow at least one connection */
    if (MaxConnections == 0)
    {
        return STATUS_INVALID_PARAMETER;
    }

    /* The request must be for a kernel handle */
    if (!(ObjectAttributes->Attributes & OBJ_KERNEL_HANDLE))
    {
        return STATUS_INVALID_PARAMETER;
    }

    /*
     * Get rundown protection on the target to stop the owner
     * from unloading whilst this port object is open. It gets
     * removed in the FltpServerPortClose callback
     */
    Status = FltObjectReference(Filter);
    if (!NT_SUCCESS(Status))
    {
        return Status;
    }

    /* Create the server port object for this filter */
    Status = ObCreateObject(KernelMode,
                            ServerPortObjectType,
                            ObjectAttributes,
                            KernelMode,
                            NULL,
                            sizeof(FLT_SERVER_PORT_OBJECT),
                            0,
                            0,
                            (PVOID *)&PortObject);
    if (NT_SUCCESS(Status))
    {
        /* Zero out the struct */
        RtlZeroMemory(PortObject, sizeof(FLT_SERVER_PORT_OBJECT));

        /* Increment the ref count on the target filter */
        FltpObjectPointerReference((PFLT_OBJECT)Filter);

        /* Setup the filter port object */
        PortObject->Filter = Filter;
        PortObject->ConnectNotify = ConnectNotifyCallback;
        PortObject->DisconnectNotify = DisconnectNotifyCallback;
        PortObject->MessageNotify = MessageNotifyCallback;
        PortObject->Cookie = ServerPortCookie;
        PortObject->MaxConnections = MaxConnections;

        /* Insert the object */
        Status = ObInsertObject(PortObject,
                                NULL,
                                STANDARD_RIGHTS_ALL | FILE_READ_DATA,
                                0,
                                NULL,
                                (PHANDLE)ServerPort);
        if (NT_SUCCESS(Status))
        {
            /* Lock the connection list */
            ExAcquireFastMutex(&Filter->ConnectionList.mLock);

            /* Add the new port object to the connection list and increment the count */
            InsertTailList(&Filter->ConnectionList.mList, &PortObject->FilterLink);
            Filter->ConnectionList.mCount++;

            /* Unlock the connection list*/
            ExReleaseFastMutex(&Filter->ConnectionList.mLock);
        }
    }

    if (!NT_SUCCESS(Status))
    {
        /* Allow the filter to be cleaned up */
        FltObjectDereference(Filter);
    }

    return Status;
}

_Must_inspect_result_ _IRQL_requires_max_

(

APC_LEVEL

)

_Must_inspect_result_ _Out_writes_bytes_opt_

(

NumberOfBytes

)

_Must_inspect_result_ _Post_writable_byte_size_

(

NumberOfBytes

)

_Post_writable_byte_size_

(

MemoryDescriptorList->

ByteCount

)

_Must_inspect_result_ _When_	(	AccessMode	= =KernelMode,
		_IRQL_requires_max_(DISPATCH_LEVEL)
	)

_Must_inspect_result_ _At_* BaseAddress

(

Mem

)

NTKERNELAPI PMDL NTAPI MmCreateMdl	(	_Out_writes_bytes_opt_(sizeof(MDL)+(sizeof(PFN_NUMBER)*ADDRESS_AND_SIZE_TO_SPAN_PAGES(Base, Length))) PMDL	MemoryDescriptorList,
		_In_reads_bytes_opt_(Length) PVOID	Base,
		_In_ SIZE_T	Length
	)

NTKERNELAPI PHYSICAL_ADDRESS NTAPI MmGetPhysicalAddress

(

_In_ PVOID

BaseAddress

)

NTKERNELAPI PVOID NTAPI MmGetVirtualForPhysical

(

_In_ PHYSICAL_ADDRESS

PhysicalAddress

)

NTKERNELAPI LOGICAL NTAPI MmIsDriverVerifying

(

_In_ struct _DRIVER_OBJECT *

DriverObject

)

NTKERNELAPI BOOLEAN NTAPI MmIsNonPagedSystemAddressValid

(

_In_ PVOID

VirtualAddress

)

NTKERNELAPI BOOLEAN NTAPI MmIsThisAnNtAsSystem

(

VOID

)

Definition at line 246 of file mmsup.c.

Referenced by FsRtlInitializeTunnels(), PsChangeQuantumTable(), and UDFInitializeZones().

{
    /* Return if this is a server system */
    return MmProductType & 0xFF;
}

NTKERNELAPI MM_SYSTEMSIZE NTAPI MmQuerySystemSize

(

VOID

)

Definition at line 257 of file mmsup.c.

Referenced by CcInitializeCacheManager(), CdInitializeGlobalData(), DriverEntry(), PspInitPhase0(), RxInitializeWorkQueueDispatcher(), and UDFInitializeZones().

{
    /* Return the low, medium or high memory system type */
    return MmSystemSize;
}

NTKERNELAPI SIZE_T NTAPI MmSizeOfMdl	(	_In_reads_bytes_opt_(Length) PVOID	Base,
		_In_ SIZE_T	Length
	)

Variable Documentation

_In_opt_ PVOID _In_opt_ PUNICODE_STRING _In_ PSECURITY_DESCRIPTOR _In_ PACCESS_STATE _In_ BOOLEAN _In_ BOOLEAN _In_ KPROCESSOR_MODE AccessMode

Definition at line 396 of file mmfuncs.h.

Referenced by BuildExplicitAccessWithNameA(), BuildExplicitAccessWithNameW(), BuildImpersonateExplicitAccessWithNameA(), BuildImpersonateExplicitAccessWithNameW(), DosCreateFileEx(), DosOpenFile(), ExpDesktopOkToClose(), ExpWindowStationOkToClose(), ExpWinStaObjectParse(), IopCreateFile(), IopParseDevice(), IopQueryAttributesFile(), NtDeleteFile(), ObpCaptureObjectCreateInformation(), and ObpIncrementHandleCount().

_Must_inspect_result_ _In_ PHYSICAL_ADDRESS _In_ PHYSICAL_ADDRESS _In_opt_ PHYSICAL_ADDRESS BoundaryAddressMultiple

Definition at line 214 of file mmfuncs.h.

Referenced by MmAllocateContiguousMemorySpecifyCache().

_In_ PHYSICAL_ADDRESS _In_ PHYSICAL_ADDRESS _In_ SIZE_T _In_ MEMORY_CACHING_TYPE CacheType

Definition at line 214 of file mmfuncs.h.

Referenced by DECLARE_INTERFACE_(), MiAllocateContiguousMemory(), MiMapLockedPagesInUserSpace(), MmAllocateContiguousMemorySpecifyCache(), MmAllocatePagesForMdlEx(), MmMapIoSpace(), MmMapLockedPagesSpecifyCache(), and TestMessageHandler().

_Inout_ PSIZE_T _In_opt_ PMDLX _In_ MM_ROTATE_DIRECTION _In_ PMM_ROTATE_COPY_CALLBACK_FUNCTION _In_opt_ PVOID Context

Definition at line 773 of file mmfuncs.h.

_Inout_ PSIZE_T _In_opt_ PMDLX _In_ MM_ROTATE_DIRECTION _In_ PMM_ROTATE_COPY_CALLBACK_FUNCTION CopyFunction

Definition at line 773 of file mmfuncs.h.

Referenced by HidParser_InitParser().

_In_ BOOLEAN DelayClose

Definition at line 593 of file mmfuncs.h.

_Inout_ PSIZE_T _In_opt_ PMDLX _In_ MM_ROTATE_DIRECTION Direction

Definition at line 773 of file mmfuncs.h.

Referenced by CUSBRequest::BuildBulkInterruptTransferDescriptor(), CUSBRequest::BuildControlTransferDescriptor(), d3dx9_set_light_parameter(), DrvBitBlt(), EngBitBlt(), EngMaskBitBlt(), EngStretchBltROP(), EngTransparentBlt(), CUSBRequest::InitDescriptor(), USB2_AllocateHS(), USB2_DeallocateHS(), USB2_GetCMASK(), USB2_GetHsOverhead(), USB2_GetOverhead(), USB2_InitTtEndpoint(), USBPORT_AllocateBandwidthUSB2(), and USBPORT_OpenPipe().

_In_ PHYSICAL_ADDRESS _In_ PHYSICAL_ADDRESS _In_ SIZE_T _In_ MEMORY_CACHING_TYPE _In_ ULONG Flags

Definition at line 749 of file mmfuncs.h.

_In_ MMFLUSH_TYPE FlushType

Definition at line 601 of file mmfuncs.h.

__kernel_entry _Inout_ _Inout_ PSIZE_T _In_ ULONG FreeType

Definition at line 810 of file mmfuncs.h.

_In_ PHYSICAL_ADDRESS HighAddress

Definition at line 226 of file mmfuncs.h.

Referenced by DECLARE_INTERFACE_(), MmAllocateNonCachedMemory(), and TestMmAllocatePagesForMdl().

_Must_inspect_result_ _In_ PHYSICAL_ADDRESS _In_ PHYSICAL_ADDRESS HighestAcceptableAddress

Definition at line 204 of file mmfuncs.h.

_In_ SIZE_T Length

Definition at line 617 of file mmfuncs.h.

_Must_inspect_result_ _In_ PHYSICAL_ADDRESS LowestAcceptableAddress

Definition at line 214 of file mmfuncs.h.

Referenced by HalAllocateCommonBuffer(), HalpGrowMapBuffers(), and MmAllocateContiguousMemorySpecifyCache().

_Must_inspect_result_ _Outptr_result_bytebuffer_ ViewSize PVOID * MappedBase

Definition at line 493 of file mmfuncs.h.

Referenced by BlImgAllocateImageBuffer(), BlImgLoadImageWithProgress2(), BlMmMapPhysicalAddressEx(), and RamdiskMapPages().

_In_ ULONG _Inout_ PMDL MemoryDescriptorList

Definition at line 406 of file mmfuncs.h.

Referenced by DECLARE_INTERFACE_().

_In_opt_ PLARGE_INTEGER NewFileSize

Definition at line 609 of file mmfuncs.h.

_Inout_ PSIZE_T _In_opt_ PMDLX NewMdl

Definition at line 773 of file mmfuncs.h.

_Must_inspect_result_ _In_ ULONG NewProtect

Definition at line 683 of file mmfuncs.h.

Referenced by MiQueryMemoryBasicInformation(), MmAlterViewAttributes(), and MmSplitRegion().

_Inout_ PSIZE_T NumberOfBytes

Definition at line 260 of file mmfuncs.h.

_In_ PEPROCESS _In_ KPROCESSOR_MODE _In_ LOCK_OPERATION Operation

Definition at line 396 of file mmfuncs.h.

_Must_inspect_result_ _In_ SIZE_T _In_ PVOID PageAddress

Definition at line 472 of file mmfuncs.h.

Referenced by _MiFlushMappedSection().

_In_ ULONG PoolTag

Definition at line 643 of file mmfuncs.h.

_Must_inspect_result_ _In_ PHYSICAL_ADDRESS _In_ PHYSICAL_ADDRESS _In_opt_ PHYSICAL_ADDRESS _In_ MEMORY_CACHING_TYPE _In_ NODE_REQUIREMENT PreferredNode

Definition at line 416 of file mmfuncs.h.

_Must_inspect_result_ _In_ _In_ ULONG ProbeMode

Definition at line 562 of file mmfuncs.h.

Referenced by ObCreateObject(), and ObpIncrementHandleCount().

_In_ PEPROCESS Process

Definition at line 396 of file mmfuncs.h.

__kernel_entry _Inout_ _Inout_ PSIZE_T RegionSize

Definition at line 810 of file mmfuncs.h.

_In_ PHYSICAL_ADDRESS _In_ PHYSICAL_ADDRESS SkipBytes

Definition at line 226 of file mmfuncs.h.

Referenced by IsDataUnicode(), MmAllocateNonCachedMemory(), TestMmAllocatePagesForMdl(), and wmain().

_In_ ULONG Tag

Initial value:

{
  
  return ((ULONG)((TagBase) + ((Tag) << HEAP_TAG_SHIFT)))

Definition at line 188 of file mmfuncs.h.

_In_ ULONG ThunkBufferSize

Definition at line 700 of file mmfuncs.h.

_In_ PHYSICAL_ADDRESS _In_ PHYSICAL_ADDRESS _In_ SIZE_T TotalBytes

Definition at line 226 of file mmfuncs.h.

Referenced by DECLARE_INTERFACE_().

_Must_inspect_result_ _Outptr_result_bytebuffer_ ViewSize PVOID _Inout_ PSIZE_T ViewSize

Definition at line 493 of file mmfuncs.h.