[pywin32-checkins] pywin32/com/win32comext/directsound/src PyDSCAPS.cpp,1.1,1.2 PyIDirectSoundBuffer.cpp,1.2,1.3 directsound.cpp,1.1,1.2

[Lars I. <lar...@us...>]

Update of /cvsroot/pywin32/pywin32/com/win32comext/directsound/src
In directory sc8-pr-cvs1.sourceforge.net:/tmp/cvs-serv29038/com/win32comext/directsound/src

Modified Files:
	PyDSCAPS.cpp PyIDirectSoundBuffer.cpp directsound.cpp 
Log Message:
Minor documentation improvements.


Index: PyDSCAPS.cpp
===================================================================
RCS file: /cvsroot/pywin32/pywin32/com/win32comext/directsound/src/PyDSCAPS.cpp,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** PyDSCAPS.cpp	30 Nov 2004 21:30:28 -0000	1.1
--- PyDSCAPS.cpp	1 Dec 2004 23:13:57 -0000	1.2
***************
*** 130,134 ****
  	{"dwPlayCpuOverheadSwBuffers",  T_INT,  OFF(m_caps.dwPlayCpuOverheadSwBuffers), 0, "Description of the processing overhead, as a percentage of the central processing unit, needed to mix software buffers (those located in main system memory). This varies according to the bus type, the processor type, and the clock speed. The unlock transfer rate for software buffers is 0 because the data need not be transferred anywhere. Similarly, the play processing overhead for hardware buffers is 0 because the mixing is done by the sound device."}, 
  	// @prop integer|dwPlayCpuOverheadSwBuffers|Description of the processing overhead, as a percentage of the central processing unit, needed to mix software buffers (those located in main system memory). This varies according to the bus type, the processor type, and the clock speed. The unlock transfer rate for software buffers is 0 because the data need not be transferred anywhere. Similarly, the play processing overhead for hardware buffers is 0 because the mixing is done by the sound device.
! 	{NULL}	/* Sentinel */
  };
  
--- 130,134 ----
  	{"dwPlayCpuOverheadSwBuffers",  T_INT,  OFF(m_caps.dwPlayCpuOverheadSwBuffers), 0, "Description of the processing overhead, as a percentage of the central processing unit, needed to mix software buffers (those located in main system memory). This varies according to the bus type, the processor type, and the clock speed. The unlock transfer rate for software buffers is 0 because the data need not be transferred anywhere. Similarly, the play processing overhead for hardware buffers is 0 because the mixing is done by the sound device."}, 
  	// @prop integer|dwPlayCpuOverheadSwBuffers|Description of the processing overhead, as a percentage of the central processing unit, needed to mix software buffers (those located in main system memory). This varies according to the bus type, the processor type, and the clock speed. The unlock transfer rate for software buffers is 0 because the data need not be transferred anywhere. Similarly, the play processing overhead for hardware buffers is 0 because the mixing is done by the sound device.
! 	{NULL}
  };
  

Index: PyIDirectSoundBuffer.cpp
===================================================================
RCS file: /cvsroot/pywin32/pywin32/com/win32comext/directsound/src/PyIDirectSoundBuffer.cpp,v
retrieving revision 1.2
retrieving revision 1.3
diff -C2 -d -r1.2 -r1.3
*** PyIDirectSoundBuffer.cpp	30 Nov 2004 21:47:02 -0000	1.2
--- PyIDirectSoundBuffer.cpp	1 Dec 2004 23:13:57 -0000	1.3
***************
*** 45,50 ****
  
  	// This is a workaround for a reference counting bug in IDirectSound:
! 	// If IDirectSound->Release() is called before IDirectSoundBuffer->Release() 
! 	// or IDirectSoundNotify->->Release(), we will get an Access Violation
  
  	// We work around this by manipulating the reference count on the Python objects 
--- 45,50 ----
  
  	// This is a workaround for a reference counting bug in IDirectSound:
! 	// If IDirectSound::Release() is called before IDirectSoundBuffer::Release() 
! 	// or IDirectSoundNotify::Release(), we will get an Access Violation
  
  	// We work around this by manipulating the reference count on the Python objects 

Index: directsound.cpp
===================================================================
RCS file: /cvsroot/pywin32/pywin32/com/win32comext/directsound/src/directsound.cpp,v
retrieving revision 1.1
retrieving revision 1.2
diff -C2 -d -r1.1 -r1.2
*** directsound.cpp	30 Nov 2004 21:30:28 -0000	1.1
--- directsound.cpp	1 Dec 2004 23:13:57 -0000	1.2
***************
*** 32,37 ****
  
  	if (!PyArg_ParseTuple(args, "|OO:DirectSoundCreate", 
! 		&obGUID, // @pyparm <o PyIID>||guid|The identifier of the interface describing the type of interface pointer to return
! 		&obUnk))  // @pyparm <o PyIUknown>|unk||The IUnknown for COM aggregation.
  	{
  		return NULL;
--- 32,37 ----
  
  	if (!PyArg_ParseTuple(args, "|OO:DirectSoundCreate", 
! 		&obGUID, // @pyparm <o PyIID>|guid|None|Address of the GUID that identifies the sound device. The value of this parameter must be one of the GUIDs returned by DirectSoundEnumerate, or None for the default device.
! 		&obUnk))  // @pyparm <o PyIUknown>|unk|None|The IUnknown for COM aggregation.
  	{
  		return NULL;
***************
*** 105,109 ****
  }
  
! // @pymethod <o list|directsound|DirectSoundEnumerate|Enumerates DirectSound drivers installed in the system.
  static PyObject *directsound_DirectSoundEnumerate(PyObject *, PyObject *args)
  {
--- 105,109 ----
  }
  
! // @pymethod <o list>|directsound|DirectSoundEnumerate|Enumerates DirectSound drivers installed in the system.
  static PyObject *directsound_DirectSoundEnumerate(PyObject *, PyObject *args)
  {
***************
*** 138,147 ****
  
  /* List of module functions */
! // @module directsound|A module, encapsulating the DirectSound interfaces
  static struct PyMethodDef directsound_methods[]=
  {
      { "DirectSoundCreate",    directsound_DirectSoundCreate, 1 }, // @pymeth DirectSoundCreate|Creates and initializes a new object that supports the IDirectSound interface.
  	{ "DirectSoundEnumerate",      directsound_DirectSoundEnumerate, 1 },      // @pymeth DirectSoundEnumerate|The DirectSoundEnumerate function enumerates the DirectSound drivers installed in the system.
! //	{ "DirectSoundCaptureCreate",  directsound_DirectSoundCaptureCreate, 1},   // @pymeth DirectSoundCaptureCreate|The DirectSoundCaptureCreate function creates and initializes an object that supports the IDirectSoundCapture interface
  //	{ "DirectSoundCaptureEnumerate",  directsound_DirectSoundCaptureEnumerate, 1},   // @pymeth DirectSoundCaptureEnumerate|The DirectSoundCaptureEnumerate function enumerates the DirectSoundCapture objects installed in the system.
  	{"DSCAPS",         PyWinMethod_NewDSCAPS, 1 },      // @pymeth DSCAPS|Creates a new <o PyDSCAPS> object.
--- 138,148 ----
  
  /* List of module functions */
! // @module directsound|A module encapsulating the DirectSound interfaces
  static struct PyMethodDef directsound_methods[]=
  {
      { "DirectSoundCreate",    directsound_DirectSoundCreate, 1 }, // @pymeth DirectSoundCreate|Creates and initializes a new object that supports the IDirectSound interface.
  	{ "DirectSoundEnumerate",      directsound_DirectSoundEnumerate, 1 },      // @pymeth DirectSoundEnumerate|The DirectSoundEnumerate function enumerates the DirectSound drivers installed in the system.
! 
! //	{ "DirectSoundCaptureCreate",  directsound_DirectSoundCaptureCreate, 1},   // @pymeth DirectSoundCaptureCreate|The DirectSoundCaptureCreate function creates and initializes an object that supports the IDirectSoundCapture interface.
  //	{ "DirectSoundCaptureEnumerate",  directsound_DirectSoundCaptureEnumerate, 1},   // @pymeth DirectSoundCaptureEnumerate|The DirectSoundCaptureEnumerate function enumerates the DirectSoundCapture objects installed in the system.
  	{"DSCAPS",         PyWinMethod_NewDSCAPS, 1 },      // @pymeth DSCAPS|Creates a new <o PyDSCAPS> object.