KLibAllocShareMem (Compact 2013)

3/28/2014

This function allocates memory that can be shared between the ISR and IST.

Syntax

BOOL KLibAllocShareMem(
  DWORD nPages,
  BOOL fNoCache,
  LPVOID* pVa,
  LPVOID* pPa
);

Parameters

  • nPages
    [in] Number of pages of memory to allocate.
  • fNoCache
    [in] If set to TRUE, noncached memory is used; otherwise, cached memory is used.
  • pVa
    [out] Pointer to a virtual memory location that can be used by the IST to access the memory.
  • pPa
    [out] Pointer to a statically mapped virtual address that can be used by the ISR to access the memory.

Return Value

None.

Remarks

The OEM that installed the ISR handler is responsible for getting the pPa pointer to the OAL. This action can be accomplished by using the KernelLibIoControl function.

This function can be called anywhere except inside the ISR context. The goal is to have a block of memory that can be seen between the ISR and the IST. Using this function in any other context is be as useful.

Requirements

Header

pkfuncs.h

Library

coredll.lib

See Also

Reference

Kernel Functions
KernelLibIoControl
KLibFreeShareMem