release/src-rt-6.x.4708/linux/linux-2.6.36/drivers/staging/tidspbridge/include/dspbridge/dspdrv.h

   1 /*
   2  * dspdrv.h
   3  *
   4  * DSP-BIOS Bridge driver support functions for TI OMAP processors.
   5  *
   6  * This is the Stream Interface for the DSp API.
   7  * All Device operations are performed via DeviceIOControl.
   8  *
   9  * Copyright (C) 2005-2006 Texas Instruments, Inc.
  10  *
  11  * This package is free software; you can redistribute it and/or modify
  12  * it under the terms of the GNU General Public License version 2 as
  13  * published by the Free Software Foundation.
  14  *
  15  * THIS PACKAGE IS PROVIDED ``AS IS'' AND WITHOUT ANY EXPRESS OR
  16  * IMPLIED WARRANTIES, INCLUDING, WITHOUT LIMITATION, THE IMPLIED
  17  * WARRANTIES OF MERCHANTIBILITY AND FITNESS FOR A PARTICULAR PURPOSE.
  18  */
  19
  20 #if !defined _DSPDRV_H_
  21 #define _DSPDRV_H_
  22
  23 #define MAX_DEV     10          /* Max support of 10 devices */
  24
  25 /*
  26  *  ======== dsp_deinit ========
  27  *  Purpose:
  28  *      This function is called by Device Manager to de-initialize a device.
  29  *      This function is not called by applications.
  30  *  Parameters:
  31  *      device_context:Handle to the device context. The XXX_Init function
  32  *      creates and returns this identifier.
  33  *  Returns:
  34  *      TRUE indicates the device successfully de-initialized. Otherwise it
  35  *      returns FALSE.
  36  *  Requires:
  37  *      device_context!= NULL. For a built in device this should never
  38  *      get called.
  39  *  Ensures:
  40  */
  41 extern bool dsp_deinit(u32 device_context);
  42
  43 /*
  44  *  ======== dsp_init ========
  45  *  Purpose:
  46  *      This function is called by Device Manager to initialize a device.
  47  *      This function is not called by applications
  48  *  Parameters:
  49  *      dw_context:  Specifies a pointer to a string containing the registry
  50  *                  path to the active key for the stream interface driver.
  51  *                  HKEY_LOCAL_MACHINE\Drivers\Active
  52  *  Returns:
  53  *      Returns a handle to the device context created. This is the our actual
  54  *      Device Object representing the DSP Device instance.
  55  *  Requires:
  56  *  Ensures:
  57  *      Succeeded:  device context > 0
  58  *      Failed:     device Context = 0
  59  */
  60 extern u32 dsp_init(u32 *init_status);
  61
  62 #endif