home *** CD-ROM | disk | FTP | other *** search
/ The Net: Ultimate Internet Guide / WWLCD1.ISO / mac / SiteBldr / AMOVIE / SDK / _SETUP / COMMON.Z / ivconfig.h < prev    next >
Encoding:
C/C++ Source or Header  |  1996-01-26  |  4.0 KB  |  116 lines
  1. //==========================================================================;
  2. //
  3. //  THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY
  4. //  KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE
  5. //  IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR
  6. //  PURPOSE.
  7. //
  8. //  Copyright (c) 1992 - 1996  Microsoft Corporation.  All Rights Reserved.
  9. //
  10. //--------------------------------------------------------------------------;
  11. //
  12. // IVideoCaptureConfigure
  13. //
  14. // Permits the filter user to configure the video driver in use by the capture source filter.
  15. // The functionality is defined by what is available through AVICap
  16. //
  17.  
  18. #ifndef __IVIDEOCAP__
  19. #define __IVIDEOCAP__
  20.  
  21. #ifdef __cplusplus
  22. extern "C" {
  23. #endif
  24.  
  25.  
  26. //
  27. // The interfaces GUID.
  28. //
  29. // {fd5010a3-8ebe-11ce-8183-00aa00577da1}
  30. DEFINE_GUID(IID_IVideoCaptureConfigure,
  31.         0xfd5010a3, 0x8ebe, 0x11ce, 0x81, 0x83, 0x00, 0xaa, 0x00, 0x57, 0x7d, 0xa1);
  32.  
  33.  
  34. DECLARE_INTERFACE_(IVideoCaptureConfigure, IUnknown) {
  35.  
  36.     // return the driver name in DriverName & S_OK or an error
  37.     STDMETHOD(get_DriverName) (THIS_
  38.                       BSTR DriverName /*[out]*/    // The driver name will be returned here.
  39.                                       // will have 80 characters allocated to it
  40.                      ) PURE;
  41.  
  42.     // return the driver version in DriverVersion & S_OK or an error
  43.     STDMETHOD(get_DriverVersion) (THIS_
  44.                      BSTR DriverVersion /*[out]*/    // The drivers version string is returned here
  45.                                  // will have 40 characters allocated to it
  46.                 ) PURE;
  47.  
  48.     // S_OK if this driver can display a Video source dialog
  49.     // S_FALSE if it can't.
  50.     STDMETHOD(get_SupportsVideoSourceDialog) (THIS) PURE;
  51.  
  52.  
  53.     // S_OK if this driver can display a Video Format dialog
  54.     // S_FALSE if it can't.
  55.     STDMETHOD(get_SupportsVideoFormatDialog) (THIS) PURE;
  56.  
  57.  
  58.     // S_OK if this driver can display a Video Display dialog
  59.     // S_FALSE if it can't.
  60.     STDMETHOD(get_SupportsVideoDisplayDialog) (THIS) PURE;
  61.  
  62.  
  63.     // S_OK if this driver can display a Video Display dialog
  64.     // S_FALSE if it can't.
  65.     STDMETHOD(get_SupportsVideoCompressionDialog) (THIS) PURE;
  66.  
  67.  
  68.     // S_OK if the dialog was displayed OK
  69.     // E_ACCESSDENIED if you can't change the format at the moment
  70.     // E_UNEXPECTED if this driver can't display this dialog.
  71.     // E_FAIL if display is attempted and fails.
  72.     STDMETHOD(DisplayVideoSourceDialog) (THIS) PURE;
  73.  
  74.     // S_OK if the dialog was displayed OK
  75.     // E_ACCESSDENIED if you can't change the format at the moment
  76.     // E_UNEXPECTED if this driver can't display this dialog.
  77.     // E_FAIL if display is attempted and fails.
  78.     STDMETHOD(DisplayVideoFormatDialog) (THIS) PURE;
  79.  
  80.  
  81.     // S_OK if the dialog was displayed OK
  82.     // E_ACCESSDENIED if you can't change the format at the moment
  83.     // E_UNEXPECTED if this driver can't display this dialog.
  84.     // E_FAIL if display is attempted and fails.
  85.     STDMETHOD(DisplayVideoCompressionDialog) (THIS) PURE;
  86.  
  87.  
  88.     // S_OK if the dialog was displayed OK
  89.     // E_ACCESSDENIED if you can't change the format at the moment
  90.     // E_UNEXPECTED if this driver can't display this dialog.
  91.     // E_FAIL if display is attempted and fails.
  92.     STDMETHOD(DisplayVideoDisplayDialog) (THIS) PURE;
  93.  
  94.  
  95.     // returns the current requested number of microseconds per frame
  96.     // in MicroSecondsperFrame.
  97.     STDMETHOD(get_RequestedMicroSecondsPerFrame) (THIS_
  98.                                    long *MicroSecondsPerFrame /*[out]*/ // 66667 == 15fps
  99.                              ) PURE;
  100.  
  101.     // Set the number of microseconds per frame to MicroSecondsPerFrame.
  102.     // returns:    S_OK if successful
  103.     //        E_ACCESSDENIED if you can't change at the moment - if the pi is connected
  104.     //        E_FAIL if it could not complete.
  105.     // Use GetMicroSecondsPerFrame to find the actual rate set.
  106.     STDMETHOD(put_RequestedMicroSecondsPerFrame) (THIS_
  107.                                                   long MicroSecondsPerFrame /*[in]*/
  108.                              ) PURE;
  109. };
  110.  
  111. #ifdef __cplusplus
  112. }
  113. #endif
  114.  
  115. #endif // __IVIDEOCAP__
  116.