OEMSaveCoProcRegister (Windows Embedded CE 6.0)

1/5/2010

This function is called by the kernel to save the platform-specific debug registers when a thread switch occurs. The same area is passed to the OEMRestoreCoProcRegister function when the thread is scheduled again.

Syntax

void OEMSaveCoProcRegister(
  LPBYTE pArea
);

Parameters

  • pArea
    [out] Pointer to a memory buffer used to store the co-processor registers.

Return Value

None.

Remarks

Leave the function pointer to NULL if the platform does not have debug registers.

To enable the kernel to call this function, the OEM must declare the function pointer, as shown in the following code example.

extern void (* pOEMSaveCoProcRegister)(LPBYTE);

During OEMInit, the OEM must assign the function pointer the address of their OEMSaveCoProcRegister function, as shown in the following code example.

pOEMSaveCoProcRegister = OEMSaveCoProcRegister;

The function is only called when both fNKSaveCoProcReg and cbNKCoProcRegSize global variables are nonzero.

Requirements

Header Developer Implemented
Library OEMMain.lib or OEMMain_StaticKITL.lib
Windows Embedded CE Windows CE .NET 4.0 and later

See Also

Reference

Optional OAL Functions
OEMRestoreCoProcRegister
OEMInitCoProcRegisterSavedArea
cbNKCoProcRegSize
fNKSaveCoProcReg