Main Page | Alphabetical List | Data Structures | Directories | File List | Data Fields | Globals | Related Pages

gpp/inc/mpcs.h File Reference

#include <dsplink.h>
#include <mpcsdefs.h>

Include dependency graph for gpp/inc/mpcs.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Defines

#define MPCS_H

Functions

EXPORT_API 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.
EXPORT_API DSP_STATUS MPCS_delete (IN ProcessorId procId, IN Pstr name)
 This function deletes the instance of the MPCS object.
EXPORT_API 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.
EXPORT_API DSP_STATUS MPCS_close (IN ProcessorId procId, IN MPCS_Handle mpcsHandle)
 This function closes an MPCS object specified by its handle.
EXPORT_API DSP_STATUS MPCS_enter (IN MPCS_Handle mpcsHandle)
 This function enters the critical section specified by the MPCS object.
EXPORT_API DSP_STATUS MPCS_leave (IN MPCS_Handle mpcsHandle)
 This function leaves the critical section specified by the MPCS object.


Define Documentation

#define MPCS_H
 

Definition at line 45 of file gpp/inc/mpcs.h.


Function Documentation

EXPORT_API DSP_STATUS MPCS_close IN ProcessorId  procId,
IN MPCS_Handle  mpcsHandle
 

This function closes an MPCS object specified by its handle.

============================================================================

Function:
MPCS_close
Parameters:
procId ID of the processor with which the MPCS is shared.
mpcsHandle Handle to the MPCS object to be closed.
Returns:
DSP_SOK Operation successfully completed. DSP_SFREE The last close for specified MPCS resulted in it getting closed. DSP_EINVALIDARG Invalid argument. DSP_EMEMORY Operation failed due to a memory error. DSP_ENOTFOUND Specified MPCS object name does not exist. DSP_EACCESSDENIED The MPCS component has not been initialized. DSP_EFAIL General failure.
Precondition:
procId must be valid. mpcsHandle must be valid.
Postcondition:
None
See also:
MPCS_open () ============================================================================

EXPORT_API 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.

============================================================================

Function:
MPCS_create
Parameters:
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.
Returns:
DSP_SOK Operation successfully completed. DSP_EINVALIDARG Invalid argument. DSP_EMEMORY Operation failed due to a memory error. DSP_EALREADYEXISTS The specified MPCS name already exists. DSP_ERESOURCE All MPCS entries are currently in use. DSP_EACCESSDENIED The MPCS component has not been initialized. DSP_EFAIL General failure.
Precondition:
procId must be valid. name must be valid. attrs must be valid.
Postcondition:
None
See also:
MPCS_delete () ============================================================================

EXPORT_API DSP_STATUS MPCS_delete IN ProcessorId  procId,
IN Pstr  name
 

This function deletes the instance of the MPCS object.

============================================================================

Function:
MPCS_delete
Parameters:
procId ID of the processor with which the MPCS is shared.
name System-wide unique name for the MPCS object.
Returns:
DSP_SOK Operation successfully completed. DSP_EINVALIDARG Invalid argument. DSP_EMEMORY Operation failed due to a memory error. DSP_ENOTFOUND Specified MPCS object name does not exist. DSP_EACCESSDENIED The MPCS component has not been initialized. DSP_EFAIL General failure.
Precondition:
procId must be valid. name must be valid.
Postcondition:
None
See also:
MPCS_create () ============================================================================

EXPORT_API DSP_STATUS MPCS_enter IN MPCS_Handle  mpcsHandle  ) 
 

This function enters the critical section specified by the MPCS object.

============================================================================

Function:
MPCS_enter
Parameters:
mpcsHandle Handle to the MPCS object.
Returns:
DSP_SOK Operation successfully completed. DSP_EFAIL General failure.
Precondition:
mpcsHandle must be valid.
Postcondition:
None
See also:
MPCS_leave () ============================================================================

EXPORT_API DSP_STATUS MPCS_leave IN MPCS_Handle  mpcsHandle  ) 
 

This function leaves the critical section specified by the MPCS object.

============================================================================

Function:
MPCS_leave
Parameters:
mpcsHandle Handle to the MPCS object.
Returns:
DSP_SOK Operation successfully completed. DSP_EFAIL General failure.
Precondition:
mpcsHandle must be valid.
Postcondition:
None
See also:
MPCS_enter () ============================================================================

EXPORT_API 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.

============================================================================

Function:
MPCS_open
Parameters:
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.
Returns:
DSP_SOK Operation successfully completed. DSP_SEXISTS The MPCS connection already exists. DSP_EINVALIDARG Invalid argument. DSP_EMEMORY Operation failed due to a memory error. DSP_ENOTFOUND Specified MPCS object name does not exist. DSP_EACCESSDENIED The MPCS component has not been initialized. DSP_EFAIL General failure.
Precondition:
procId must be valid. name must be valid. mpcsHandle must be a valid pointer.
Postcondition:
None
See also:
MPCS_close () ============================================================================


Generated on Fri Jul 16 14:34:07 2010 for DSP/BIOSLink by  doxygen 1.4.4