Edit

Share via

MmGetMdlPfnArray macro (wdm.h)

  • Article

The MmGetMdlPfnArray macro returns a pointer to the beginning of the array of physical page numbers that are associated with a memory descriptor list (MDL).

Syntax

PPFN_NUMBER MmGetMdlPfnArray(
  _In_ PMDL Mdl
);

Parameters

Mdl

A pointer to an MDL.

Return value

MmGetMdlPfnArray returns a pointer to the beginning of the array of physical page numbers that are associated with the MDL.

Remarks

MmGetMdlPfnArray returns a pointer to the beginning of the array of physical page numbers that are associated with the MDL.

Macro definition:

#define MmGetMdlPfnArray(Mdl) ((PPFN_NUMBER)(Mdl + 1))

The number of entries in the array is ADDRESS_AND_SIZE_TO_SPAN_PAGES(MmGetMdlVirtualAddress(Mdl), MmGetMdlByteCount(Mdl)).

Each array element is an integer value of type PFN_NUMBER, which is defined in the Wdm.h header file as follows:

typedef ULONG PFN_NUMBER, *PPFN_NUMBER;

Changing the contents of the array can cause subtle system problems that are difficult to diagnose. We recommend that you do not read or change the contents of this array.

For pageable memory, the contents of the array are valid only for a buffer locked with MmProbeAndLockPages.

For nonpaged pool, the contents of the array are valid only for an MDL updated with MmBuildMdlForNonPagedPool, MmAllocatePagesForMdlEx, or MmAllocatePagesForMdl.

For more information about MDLs, see Using MDLs.

Requirements

Requirement Value
Header wdm.h (include Wdm.h)
IRQL Any level
DDI compliance rules MdlAfterReqCompletedIntIoctlA(kmdf), MdlAfterReqCompletedIoctlA(kmdf), MdlAfterReqCompletedReadA(kmdf), MdlAfterReqCompletedWriteA(kmdf)