include/realmedia/rmapends.h

   1 /****************************************************************************
   2  *
   3  *  $Id: rmapends.h 7 2003-05-30 02:18:02Z gabest $
   4  *
   5  *  Copyright (C) 1995-1999 RealNetworks, Inc. All rights reserved.
   6  *
   7  *  http://www.real.com/devzone
   8  *
   9  *  This program contains proprietary
  10  *  information of Progressive Networks, Inc, and is licensed
  11  *  subject to restrictions on use and distribution.
  12  *
  13  *
  14  *  Pending Status interfaces
  15  *
  16  */
  17
  18 #ifndef _RMAPENDS_H_
  19 #define _RMAPENDS_H_
  20
  21 /*
  22  * Forward declarations of some interfaces defined or used here-in.
  23  */
  24 typedef _INTERFACE      IUnknown                        IUnknown;
  25 typedef _INTERFACE      IRMAPendingStatus               IRMAPendingStatus;
  26
  27
  28 /****************************************************************************
  29  *
  30  *  Interface:
  31  *
  32  *      IRMAPendingStatus
  33  *
  34  *  Purpose:
  35  *
  36  *      Interface to get the current pending status from an object
  37  *
  38  *  IRMAPendingStatus:
  39  *
  40  *      {00001100-0901-11d1-8B06-00A024406D59}
  41  */
  42
  43 DEFINE_GUID(IID_IRMAPendingStatus, 0x00001100, 0x901, 0x11d1, 0x8b, 0x6, 0x0,
  44                         0xa0, 0x24, 0x40, 0x6d, 0x59);
  45
  46 #undef  INTERFACE
  47 #define INTERFACE   IRMAPendingStatus
  48
  49 #define RMA_STATUS_INITIALIZING 0x01
  50 #define RMA_STATUS_BUFFERING    0x02
  51 #define RMA_STATUS_CONTACTING   0x03
  52 #define RMA_STATUS_READY        0x04
  53
  54 DECLARE_INTERFACE_(IRMAPendingStatus, IUnknown)
  55 {
  56     /*
  57      * IUnknown methods
  58      */
  59     STDMETHOD(QueryInterface)   (THIS_
  60                                 REFIID riid,
  61                                 void** ppvObj) PURE;
  62
  63     STDMETHOD_(ULONG,AddRef)    (THIS) PURE;
  64
  65     STDMETHOD_(ULONG,Release)   (THIS) PURE;
  66
  67     /*
  68      * IRMAPendingStatus methods
  69      */
  70
  71     /************************************************************************
  72      *  Method:
  73      *      IRMAPendingStatus::GetStatus
  74      *  Purpose:
  75      *      Called by the user to get the current pending status from an object
  76      */
  77     STDMETHOD(GetStatus)        (THIS_
  78                                 REF(UINT16) uStatusCode,
  79                                 REF(IRMABuffer*) pStatusDesc,
  80                                 REF(UINT16) ulPercentDone) PURE;
  81 };
  82
  83 #endif /* _RMAPENDS_H_ */