KLibAllocShareMem (Windows Embedded CE 6.0)

1/5/2010

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.

KLibAllocShareMem 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 KLibAllocShareMem in any other context is be as useful.

Requirements

See Also

Reference

Optional OAL Functions
KLibFreeShareMem

Other Resources

KernelLibIoControl