#include <dsplink.h>
#include <mpcsdefs.h>
Go to the source code of this file.
Functions | |
DLLEXPORT DSP_STATUS | MPCS_create (IN ProcessorId procId, IN Pstr name, IN MPCS_ShObj *mpcsShObj, IN MPCS_Attrs *attrs) |
This function creates and initializes an instance of the MPCS object. The memory for the object may or may not be provided by the user. If provided by the user, the memory for the object must be shared across the processors using the MPCS. It must also already be mapped into user space for OSes supporting user/kernel separation. | |
DLLEXPORT DSP_STATUS | MPCS_delete (IN ProcessorId procId, IN Pstr name) |
This function deletes the instance of the MPCS object. | |
DLLEXPORT DSP_STATUS | MPCS_open (IN ProcessorId procId, IN Pstr name, OUT MPCS_Handle *mpcsHandle) |
This function opens an MPCS object specified by its name and gets a handle to the object. Every process that needs to use the MPCS object must get a handle to the object by calling this API. | |
DLLEXPORT DSP_STATUS | MPCS_close (IN ProcessorId procId, IN MPCS_Handle mpcsHandle) |
This function closes an MPCS object specified by its handle. | |
DLLEXPORT DSP_STATUS | MPCS_enter (IN MPCS_Handle mpcsHandle) |
This function enters the critical section specified by the MPCS object. | |
DLLEXPORT DSP_STATUS | MPCS_leave (IN MPCS_Handle mpcsHandle) |
This function leaves the critical section specified by the MPCS object. |
DLLEXPORT DSP_STATUS MPCS_create | ( | IN ProcessorId | procId, |
IN Pstr | name, | ||
IN MPCS_ShObj * | mpcsShObj, | ||
IN MPCS_Attrs * | attrs | ||
) |
This function creates and initializes an instance of the MPCS object. The memory for the object may or may not be provided by the user. If provided by the user, the memory for the object must be shared across the processors using the MPCS. It must also already be mapped into user space for OSes supporting user/kernel separation.
============================================================================
procId | ID of the processor with which the MPCS object is to be shared. |
name | System-wide unique name for the MPCS object. |
mpcsShObj | Pointer to the shared MPCS object. If memory for the MPCS object is provided by the user, the MPCS object handle is not NULL. Otherwise, if the memory is to be allocated by the MPCS component, the MPCS object handle can be specified as NULL. |
attrs | Attributes for creation of the MPCS object. |
DLLEXPORT DSP_STATUS MPCS_delete | ( | IN ProcessorId | procId, |
IN Pstr | name | ||
) |
This function deletes the instance of the MPCS object.
============================================================================
procId | ID of the processor with which the MPCS is shared. |
name | System-wide unique name for the MPCS object. |
DLLEXPORT DSP_STATUS MPCS_open | ( | IN ProcessorId | procId, |
IN Pstr | name, | ||
OUT MPCS_Handle * | mpcsHandle | ||
) |
This function opens an MPCS object specified by its name and gets a handle to the object. Every process that needs to use the MPCS object must get a handle to the object by calling this API.
============================================================================
procId | ID of the processor with which the MPCS object is to be shared. |
name | System-wide unique name for the MPCS object. |
mpcsHandle | Location to receive the MPCS object handle, which is valid in the process space of the calling process. |
DLLEXPORT DSP_STATUS MPCS_close | ( | IN ProcessorId | procId, |
IN MPCS_Handle | mpcsHandle | ||
) |
This function closes an MPCS object specified by its handle.
============================================================================
procId | ID of the processor with which the MPCS is shared. |
mpcsHandle | Handle to the MPCS object to be closed. |
DLLEXPORT DSP_STATUS MPCS_enter | ( | IN MPCS_Handle | mpcsHandle ) |
This function enters the critical section specified by the MPCS object.
============================================================================
mpcsHandle | Handle to the MPCS object. |
DLLEXPORT DSP_STATUS MPCS_leave | ( | IN MPCS_Handle | mpcsHandle ) |
This function leaves the critical section specified by the MPCS object.
============================================================================
mpcsHandle | Handle to the MPCS object. |