L_InetSendSound

#include "l_bitmap.h"
#include "ltnet.h"

L_LTNET_API L_INT L_InetSendSound(hComputer, pWaveFormatData, pWaveData, pdwDataSize)

Sends sound data to a remote computer.

Returns

Comments

This function sends the pWaveFormatData structure first, including all the extra bytes needed by the format. It then sends the pWaveData structure, followed by the actual sound data.

The remote computer will receive an INET_SOUND_RECEIVED notification and pBuffer will point to pWaveFormatData. The remote computer will have to obtain the pointer to pWaveData. Since this structure follows the pWaveFormatData structure, use the SIZEOF_WAVEFORMATDATA macro to determine the size of the pWaveFormatData structure and thus the start of the pWaveData structure. On the remote computer, LEADTOOLS automatically adjusts pWaveData->lpData to point to the sound data.

The remote end can use pWaveFormatData and pWaveData to save the sound to a file, or to play it (using L_CapStartFeedSound).

The sound format is sent every time so that it will facilitate handling multiple connections to different computers that are recording sound in different formats.

You must initialize the LEADTOOLS Internet DLL using L_InetStartUp before calling this function.

Required DLLs and Libraries

See Also

Example

For a more complex example, you can look at the source for the NETCAP example. This example contains code for both the server and the client program and shows how sound can be captured by the client and sent to the server.

static L_COMP hServer;
L_COMP hClient;
HGLOBAL hSoundServer;
HGLOBAL hSoundClient;
// ------------ code on the server side -------------
L_INT EXT_CALLBACK InetCallbackServer(L_COMP   hComp,
                                      L_INT    nMessage,
                                      L_INT    nError,
                                      L_CHAR * pBuffer,
                                      L_INT32  lSize,
                                      L_VOID * pUserData)
{
   UNREFERENCED_PARAMETER(hComp);
   UNREFERENCED_PARAMETER(lSize);
   UNREFERENCED_PARAMETER(pUserData);
   switch(nMessage)
   {
      case INET_CONNECT_REQUEST: // somebody wants to connect with us
         if(nError == SUCCESS)
         {
            L_InetAcceptConnect (hServer, &hClient, (INETCALLBACK) InetCallbackServer, NULL);
            if(hSoundServer)
               L_CapStopFeedSound(hSoundServer, TRUE);
            hSoundServer = NULL;
         }
      break;
      case INET_SOUND_RECEIVED:
         // note: we will do less error checking to make the code simpler
         // still check for nError being SUCCESS to make sure we won't get memory violations
         if(nError == SUCCESS)
         {
            LPWAVEFORMATDATA pFormatData = (LPWAVEFORMATDATA)pBuffer;
            LPWAVEDATA pWaveData = (LPWAVEDATA)(pBuffer + SIZEOF_WAVEFORMATDATA(pFormatData));
            if(!hSoundServer)
               // first time we received sound data. start playing the sound
               L_CapStartFeedSound(&hSoundServer, NULL, CAP_DEVICE_MAPPER, pFormatData, 0, CAP_FEED_PLAYDATA, NULL, NULL);
            L_CapFeedSound (hSoundServer, pWaveData);
         }
      break;
   }
   return TRUE;
}
L_VOID InetConnectExampleServer(L_VOID)
{
   if(L_InetServerInit(1000,&hServer,(INETCALLBACK) InetCallbackServer,NULL) != SUCCESS)
      MessageBox(NULL, TEXT("Error attempting to start the server"), TEXT("ERROR"), MB_OK);
   // at some point, before the end of the server program you should do
   // L_InetClose(hServer, FALSE); or L_InetClose(hServer, TRUE);
   // L_CapStopFeedSound(hSoundServer, FALSE); or L_CapStopFeedSound(hSoundServer, TRUE);
}
// ----------- code on the client side -------------
L_INT EXT_CALLBACK InetSendSoundExample(LPWAVEDATA pWaveData,
                                        L_VOID   * pUserData)
{
   UNREFERENCED_PARAMETER(pUserData);
   LPWAVEFORMATDATA pWaveFormatData = NULL;
   L_SIZE_T dwTotalSize;
   L_InetSendSound(hClient, pWaveFormatData, pWaveData, &dwTotalSize);
   // dwTotalSize has now the size of the data being sent
   return SUCCESS;
}
L_INT L_CapOpenRecord(L_VOID*, L_INT, L_VOID*, L_INT, L_INT, INETCALLBACK, L_VOID*)
{
   return 0;
}
L_INT EXT_CALLBACK InetCallbackClient(L_COMP   hComp,
                                      L_INT    nMessage,
                                      L_INT    nError,
                                      L_CHAR * pBuffer,
                                      L_UINT32 lSize,
                                      L_VOID * pUserData)
{
   UNREFERENCED_PARAMETER(pUserData);
   UNREFERENCED_PARAMETER(lSize);
   UNREFERENCED_PARAMETER(pBuffer);
   L_UINT uWaveFormatSize;
   LPWAVEFORMATDATA pWaveFormatData;
   switch(nMessage)
   {
      case INET_CONNECT: 
         /* check the status and send some data */
         if(nError == SUCCESS)
         {
            // note: hComp will be the same as hClient. but you can reassign it anyway
            hClient = hComp;
            // start recording in the current default Windows format
            // get the format size
            L_CapGetDefaultAudFormat(NULL, &uWaveFormatSize, NULL, NULL);
            // allocate memory and get the format
            pWaveFormatData = (LPWAVEFORMATDATA) GlobalAllocPtr(GMEM_MOVEABLE, uWaveFormatSize);
            L_CapGetDefaultAudFormat(pWaveFormatData, &uWaveFormatSize, NULL, NULL);
            if(L_CapOpenRecord(&hSoundClient, CAP_DEVICE_MAPPER, pWaveFormatData, 0, pWaveFormatData->nAvgBytesPerSec, (INETCALLBACK) RecordCallback, NULL) != SUCCESS)
            {
               MessageBox(NULL, TEXT("Error starting recording!"), TEXT("Error"), MB_OK);
               break;
            }
            else
               L_CapStartRecord (hSoundClient);
            // i don't need this anymore
            GlobalFreePtr(pWaveFormatData);
         }
      break;
   }
   return SUCCESS;
}
L_VOID InetConnectExampleClient(L_VOID)
{
   /* Note: Instead of server_address you need to put the IP address
            of the computer running the server. You can also put in
            the computer name, if the server is running on a local network */
   //...
   if(L_InetConnect ("server_address", 1000, &hClient, (INETCALLBACK) InetCallbackClient, NULL) != SUCCESS)
      MessageBox(NULL, TEXT("Error attempting to connect"), TEXT("ERROR"), MB_OK);
   //...
   // somewhere before the end of the program you should do
   // L_InetClose(hRemoteServer, FALSE); or L_InetClose(hRemoteServer, TRUE);
   // L_CapCloseRecord(hSoundClient);
}