开通博客赚积分
发布资源赚积分
分类

源码开发语言/平台
当前位置：首页 > 源码/资料 > Windows编程 > 多媒体编程 > 查看源码
IsochronousDataHandler.h
资源名称：fullMPCcode.rar　[点击查看]
上传用户：xjjlds
上传日期：2015-12-05
资源大小：22823k
文件大小：18k
源码类别：

多媒体编程

开发平台：

Visual C++

IsochronousDataHandler.h：源码内容
  1. /*
  2.      File:       IsochronousDataHandler.h
  3.  
  4.      Contains:   The defines the client API to an Isochronous Data Handler, which is
  5.  
  6.      Version:    Technology: xxx put version here xxx
  7.                  Release:    QuickTime 6.0.2
  8.  
  9.      Copyright:  (c) 1997-2001 by Apple Computer, Inc., all rights reserved.
  10.  
  11.      Bugs?:      For bug reports, consult the following page on
  12.                  the World Wide Web:
  13.  
  14.                      http://developer.apple.com/bugreporter/
  15.  
  16. */
  17. //
  18. // Check for Prior Inclusion of IsochronousDataHandler.r
  19. //  If this header is trying to be included via a Rez path, make it act
  20. //  as a NOP.  This will allow both Rez & C files to get to use the
  21. //  contants for the component type, subtype, and interface version.
  22. #ifndef __ISOCHRONOUSDATAHANDLER_R__
  25. #ifndef __ISOCHRONOUSDATAHANDLER__
  26. #define __ISOCHRONOUSDATAHANDLER__
  28. #ifndef __MACTYPES__
  29. #include "MacTypes.h"
  30. #endif
  32. #ifndef __MOVIESFORMAT__
  33. #include "MoviesFormat.h"
  34. #endif
  36. #ifndef __QUICKTIMECOMPONENTS__
  37. #include "QuickTimeComponents.h"
  38. #endif
  46. #if PRAGMA_ONCE
  47. #pragma once
  48. #endif
  50. #ifdef __cplusplus
  51. extern "C" {
  52. #endif
  54. #if PRAGMA_IMPORT
  55. #pragma import on
  56. #endif
  58. #if PRAGMA_STRUCT_ALIGN
  59.     #pragma options align=mac68k
  60. #elif PRAGMA_STRUCT_PACKPUSH
  61.     #pragma pack(push, 2)
  62. #elif PRAGMA_STRUCT_PACK
  63.     #pragma pack(2)
  64. #endif
  66. enum {
  67.     kIDHComponentType           = FOUR_CHAR_CODE('ihlr'),       /* Component type*/
  68.     kIDHSubtypeDV               = FOUR_CHAR_CODE('dv  '),       /* Subtype for DV (over FireWire)*/
  69.     kIDHSubtypeFireWireConference = FOUR_CHAR_CODE('fwc ')      /* Subtype for FW Conference*/
  70. };
  73. /* Version of Isochronous Data Handler API*/
  74. enum {
  75.     kIDHInterfaceVersion1       = 0x0001                        /* Initial relase (Summer '99)*/
  76. };
  79. /* atom types*/
  81. enum {
  82.     kIDHDeviceListAtomType      = FOUR_CHAR_CODE('dlst'),
  83.     kIDHDeviceAtomType          = FOUR_CHAR_CODE('devc'),       /* to be defined elsewhere*/
  84.     kIDHIsochServiceAtomType    = FOUR_CHAR_CODE('isoc'),
  85.     kIDHIsochModeAtomType       = FOUR_CHAR_CODE('mode'),
  86.     kIDHDeviceIDType            = FOUR_CHAR_CODE('dvid'),
  87.     kIDHDefaultIOType           = FOUR_CHAR_CODE('dfio'),
  88.     kIDHIsochVersionAtomType    = FOUR_CHAR_CODE('iver'),
  89.     kIDHUniqueIDType            = FOUR_CHAR_CODE('unid'),
  90.     kIDHNameAtomType            = FOUR_CHAR_CODE('name'),
  91.     kIDHUseCMPAtomType          = FOUR_CHAR_CODE('ucmp'),
  92.     kIDHIsochMediaType          = FOUR_CHAR_CODE('av  '),
  93.     kIDHDataTypeAtomType        = FOUR_CHAR_CODE('dtyp'),
  94.     kIDHDataSizeAtomType        = FOUR_CHAR_CODE('dsiz'),       /* ??? packet size vs. buffer size*/
  95.     kIDHDataBufferSizeAtomType  = FOUR_CHAR_CODE('dbuf'),       /* ??? packet size vs. buffer size*/
  96.     kIDHDataIntervalAtomType    = FOUR_CHAR_CODE('intv'),
  97.     kIDHDataIODirectionAtomType = FOUR_CHAR_CODE('ddir'),
  98.     kIDHSoundMediaAtomType      = FOUR_CHAR_CODE('soun'),
  99.     kIDHSoundTypeAtomType       = FOUR_CHAR_CODE('type'),
  100.     kIDHSoundChannelCountAtomType = FOUR_CHAR_CODE('ccnt'),
  101.     kIDHSoundSampleSizeAtomType = FOUR_CHAR_CODE('ssiz'),
  102.     kIDHSoundSampleRateAtomType = FOUR_CHAR_CODE('srat'),       /* same as video out... (what does this comment mean?)*/
  103.     kIDHVideoMediaAtomType      = FOUR_CHAR_CODE('vide'),
  104.     kIDHVideoDimensionsAtomType = FOUR_CHAR_CODE('dimn'),
  105.     kIDHVideoResolutionAtomType = FOUR_CHAR_CODE('resl'),
  106.     kIDHVideoRefreshRateAtomType = FOUR_CHAR_CODE('refr'),
  107.     kIDHVideoPixelTypeAtomType  = FOUR_CHAR_CODE('pixl'),
  108.     kIDHVideoDecompressorAtomType = FOUR_CHAR_CODE('deco'),
  109.     kIDHVideoDecompressorTypeAtomType = FOUR_CHAR_CODE('dety'),
  110.     kIDHVideoDecompressorContinuousAtomType = FOUR_CHAR_CODE('cont'),
  111.     kIDHVideoDecompressorComponentAtomType = FOUR_CHAR_CODE('cmpt')
  112. };
  114. /* I/O Flags */
  115. enum {
  116.     kIDHDataTypeIsInput         = 1L << 0,
  117.     kIDHDataTypeIsOutput        = 1L << 1,
  118.     kIDHDataTypeIsInputAndOutput = 1L << 2
  119. };
  122. /* Permission Flags */
  123. enum {
  124.     kIDHOpenForReadTransactions = 1L << 0,
  125.     kIDHOpenForWriteTransactions = 1L << 1,
  126.     kIDHOpenWithExclusiveAccess = 1L << 2,
  127.     kIDHOpenWithHeldBuffers     = 1L << 3,                      /* IDH will hold buffer until ReleaseBuffer()*/
  128.     kIDHCloseForReadTransactions = 1L << 4,
  129.     kIDHCloseForWriteTransactions = 1L << 5
  130. };
  133. /*
  134.    Errors 
  135.     These REALLY need to be moved into Errors.h
  136.    ooo.needs officially assigned numbers
  137. */
  138. enum {
  139.     kIDHErrDeviceDisconnected   = -14101,
  140.     kIDHErrInvalidDeviceID      = -14102,
  141.     kIDHErrDeviceInUse          = -14104,
  142.     kIDHErrDeviceNotOpened      = -14105,
  143.     kIDHErrDeviceBusy           = -14106,
  144.     kIDHErrDeviceReadError      = -14107,
  145.     kIDHErrDeviceWriteError     = -14108,
  146.     kIDHErrDeviceNotConfigured  = -14109,
  147.     kIDHErrDeviceList           = -14110,
  148.     kIDHErrCompletionPending    = -14111,
  149.     kIDHErrDeviceTimeout        = -14112,
  150.     kIDHErrInvalidIndex         = -14113,
  151.     kIDHErrDeviceCantRead       = -14114,
  152.     kIDHErrDeviceCantWrite      = -14115,
  153.     kIDHErrCallNotSupported     = -14116
  154. };
  159. /* Holds Device Identification...*/
  160. typedef UInt32                          IDHDeviceID;
  161. enum {
  162.     kIDHInvalidDeviceID         = 0,
  163.     kIDHDeviceIDEveryDevice     = (long)0xFFFFFFFF
  164. };
  166. /* Values for 5 bit STYPE part of CIP header*/
  167. enum {
  168.     kIDHDV_SD                   = 0,
  169.     kIDHDV_SDL                  = 1,
  170.     kIDHDV_HD                   = 2,
  171.     kIDHDVCPro_25               = 0x1E
  172. };
  174. /*  Isoch Interval Atom Data*/
  176. struct IDHIsochInterval {
  177.     SInt32                          duration;
  178.     TimeScale                       scale;
  179. };
  180. typedef struct IDHIsochInterval         IDHIsochInterval;
  181. /* Need to fix this.  For now, cast this as a FWReferenceID*/
  182. typedef struct OpaquePsuedoID*          PsuedoID;
  183. /*
  184.    Isoch Device Status
  185.     This is atom-like, but isn't an atom
  186. */
  188. struct IDHDeviceStatus {
  189.     UInt32                          version;
  190.     Boolean                         physicallyConnected;
  191.     Boolean                         readEnabled;
  192.     Boolean                         writeEnabled;
  193.     Boolean                         exclusiveAccess;
  194.     UInt32                          currentBandwidth;
  195.     UInt32                          currentChannel;
  196.     PsuedoID                        localNodeID;                /*ooo.may go in atoms */
  197.     SInt16                          inputStandard;              /* One of the QT input standards*/
  198.     Boolean                         deviceActive;
  199.     UInt8                           inputFormat;                /* Expected STYPE of data from device, if version >= 0x200*/
  200.     UInt32                          outputFormats;              /* Bitmask for supported STYPE values, if version >= 0x200*/
  201. };
  202. typedef struct IDHDeviceStatus          IDHDeviceStatus;
  203. /*
  204.    Isochronous Data Handler Events
  205.     
  206. */
  208. typedef UInt32 IDHEvent;
  209. enum {
  210.     kIDHEventInvalid            = 0,
  211.     kIDHEventDeviceAdded        = 1L << 0,                      /* A new device has been added to the bus*/
  212.     kIDHEventDeviceRemoved      = 1L << 1,                      /* A device has been removed from the bus*/
  213.     kIDHEventDeviceChanged      = 1L << 2,                      /* Some device has changed state on the bus*/
  214.     kIDHEventReadEnabled        = 1L << 3,                      /* A client has enabled a device for read*/
  215.     kIDHEventReserved1          = 1L << 4,                      /* Reserved for future use*/
  216.     kIDHEventReadDisabled       = 1L << 5,                      /* A client has disabled a device from read*/
  217.     kIDHEventWriteEnabled       = 1L << 6,                      /* A client has enabled a device for write*/
  218.     kIDHEventReserved2          = 1L << 7,                      /* Reserved for future use*/
  219.     kIDHEventWriteDisabled      = 1L << 8,                      /* A client has disabled a device for write*/
  220.     kIDHEventEveryEvent         = (unsigned long)0xFFFFFFFF
  221. };
  224. typedef UInt32                          IDHNotificationID;
  226. struct IDHEventHeader {
  227.     IDHDeviceID                     deviceID;                   /* Device which generated event*/
  228.     IDHNotificationID               notificationID;
  229.     IDHEvent                        event;                      /* What the event is*/
  230. };
  231. typedef struct IDHEventHeader           IDHEventHeader;
  235. /*
  236.    IDHGenericEvent
  237.     An IDH will often have to post events from at interrupt time.  Since memory
  238.     allocation cannot occur from the interrupt handler, the IDH can preallocate
  239.     storage needed for handling the event by creating some IDHGenericEvent items.
  240.     Subsequently, when an event is generated, the type of event (specified in the
  241.     IDHEventHeader) will dictate how the IDHGenericEvent should be interpretted.
  242.     
  243.     IMPORTANT NOTE : This means that a specific event structure can NEVER be greater
  244.     than the size of the generic one.
  245.     
  246. */
  248. struct IDHGenericEvent {
  249.     IDHEventHeader                  eventHeader;
  250.     UInt32                          pad[4];
  251. };
  252. typedef struct IDHGenericEvent          IDHGenericEvent;
  253. /*
  254.    IDHDeviceConnectionEvent
  255.     For kIDHEventDeviceAdded or kIDHEventDeviceRemoved events.
  256. */
  258. struct IDHDeviceConnectionEvent {
  259.     IDHEventHeader                  eventHeader;
  260. };
  261. typedef struct IDHDeviceConnectionEvent IDHDeviceConnectionEvent;
  262. /*
  263.    IDHDeviceIOEnableEvent
  264.     For kIDHEventReadEnabled, kIDHEventReadDisabled, kIDHEventWriteEnabled, or
  265.     kIDHEventWriteDisabled.
  266. */
  268. struct IDHDeviceIOEnableEvent {
  269.     IDHEventHeader                  eventHeader;
  270. };
  271. typedef struct IDHDeviceIOEnableEvent   IDHDeviceIOEnableEvent;
  272. typedef CALLBACK_API_C( OSStatus , IDHNotificationProcPtr )(IDHGenericEvent *event, void *userData);
  274. typedef IDHNotificationProcPtr          IDHNotificationProc;
  275. typedef TVECTOR_UPP_TYPE(IDHNotificationProcPtr)                IDHNotificationUPP;
  277. struct IDHParameterBlock {
  278.     UInt32                          reserved1;
  279.     UInt16                          reserved2;
  280.     void *                          buffer;
  281.     ByteCount                       requestedCount;
  282.     ByteCount                       actualCount;
  283.     IDHNotificationUPP              completionProc;
  284.     void *                          refCon;
  285.     OSErr                           result;
  286. };
  287. typedef struct IDHParameterBlock        IDHParameterBlock;
  289. struct IDHResolution {
  290.     UInt32                          x;
  291.     UInt32                          y;
  292. };
  293. typedef struct IDHResolution            IDHResolution;
  295. struct IDHDimension {
  296.     Fixed                           x;
  297.     Fixed                           y;
  298. };
  299. typedef struct IDHDimension             IDHDimension;
  301. EXTERN_API( ComponentResult )
  302. IDHGetDeviceList                (ComponentInstance      idh,
  303.                                  QTAtomContainer *      deviceList)                         FIVEWORDINLINE(0x2F3C, 0x0004, 0x0001, 0x7000, 0xA82A);
  305. EXTERN_API( ComponentResult )
  306. IDHGetDeviceConfiguration       (ComponentInstance      idh,
  307.                                  QTAtomSpec *           configurationID)                    FIVEWORDINLINE(0x2F3C, 0x0004, 0x0002, 0x7000, 0xA82A);
  309. EXTERN_API( ComponentResult )
  310. IDHSetDeviceConfiguration       (ComponentInstance      idh,
  311.                                  const QTAtomSpec *     configurationID)                    FIVEWORDINLINE(0x2F3C, 0x0004, 0x0003, 0x7000, 0xA82A);
  313. EXTERN_API( ComponentResult )
  314. IDHGetDeviceStatus              (ComponentInstance      idh,
  315.                                  const QTAtomSpec *     configurationID,
  316.                                  IDHDeviceStatus *      status)                             FIVEWORDINLINE(0x2F3C, 0x0008, 0x0004, 0x7000, 0xA82A);
  318. EXTERN_API( ComponentResult )
  319. IDHGetDeviceClock               (ComponentInstance      idh,
  320.                                  Component *            clock)                              FIVEWORDINLINE(0x2F3C, 0x0004, 0x0005, 0x7000, 0xA82A);
  322. EXTERN_API( ComponentResult )
  323. IDHOpenDevice                   (ComponentInstance      idh,
  324.                                  UInt32                 permissions)                        FIVEWORDINLINE(0x2F3C, 0x0004, 0x0006, 0x7000, 0xA82A);
  326. EXTERN_API( ComponentResult )
  327. IDHCloseDevice                  (ComponentInstance      idh)                                FIVEWORDINLINE(0x2F3C, 0x0000, 0x0007, 0x7000, 0xA82A);
  329. EXTERN_API( ComponentResult )
  330. IDHRead                         (ComponentInstance      idh,
  331.                                  IDHParameterBlock *    pb)                                 FIVEWORDINLINE(0x2F3C, 0x0004, 0x0008, 0x7000, 0xA82A);
  333. EXTERN_API( ComponentResult )
  334. IDHWrite                        (ComponentInstance      idh,
  335.                                  IDHParameterBlock *    pb)                                 FIVEWORDINLINE(0x2F3C, 0x0004, 0x0009, 0x7000, 0xA82A);
  337. EXTERN_API( ComponentResult )
  338. IDHNewNotification              (ComponentInstance      idh,
  339.                                  IDHDeviceID            deviceID,
  340.                                  IDHNotificationUPP     notificationProc,
  341.                                  void *                 userData,
  342.                                  IDHNotificationID *    notificationID)                     FIVEWORDINLINE(0x2F3C, 0x0010, 0x000A, 0x7000, 0xA82A);
  344. EXTERN_API( ComponentResult )
  345. IDHNotifyMeWhen                 (ComponentInstance      idh,
  346.                                  IDHNotificationID      notificationID,
  347.                                  IDHEvent               events)                             FIVEWORDINLINE(0x2F3C, 0x0008, 0x000B, 0x7000, 0xA82A);
  349. EXTERN_API( ComponentResult )
  350. IDHCancelNotification           (ComponentInstance      idh,
  351.                                  IDHNotificationID      notificationID)                     FIVEWORDINLINE(0x2F3C, 0x0004, 0x000C, 0x7000, 0xA82A);
  353. EXTERN_API( ComponentResult )
  354. IDHDisposeNotification          (ComponentInstance      idh,
  355.                                  IDHNotificationID      notificationID)                     FIVEWORDINLINE(0x2F3C, 0x0004, 0x000D, 0x7000, 0xA82A);
  357. EXTERN_API( ComponentResult )
  358. IDHReleaseBuffer                (ComponentInstance      idh,
  359.                                  IDHParameterBlock *    pb)                                 FIVEWORDINLINE(0x2F3C, 0x0004, 0x000E, 0x7000, 0xA82A);
  361. EXTERN_API( ComponentResult )
  362. IDHCancelPendingIO              (ComponentInstance      idh,
  363.                                  IDHParameterBlock *    pb)                                 FIVEWORDINLINE(0x2F3C, 0x0004, 0x000F, 0x7000, 0xA82A);
  365. EXTERN_API( ComponentResult )
  366. IDHGetDeviceControl             (ComponentInstance      idh,
  367.                                  ComponentInstance *    deviceControl)                      FIVEWORDINLINE(0x2F3C, 0x0004, 0x0010, 0x7000, 0xA82A);
  369. EXTERN_API( ComponentResult )
  370. IDHUpdateDeviceList             (ComponentInstance      idh,
  371.                                  QTAtomContainer *      deviceList)                         FIVEWORDINLINE(0x2F3C, 0x0004, 0x0011, 0x7000, 0xA82A);
  373. EXTERN_API( ComponentResult )
  374. IDHGetDeviceTime                (ComponentInstance      idh,
  375.                                  TimeRecord *           deviceTime)                         FIVEWORDINLINE(0x2F3C, 0x0004, 0x0012, 0x7000, 0xA82A);
  377. EXTERN_API( ComponentResult )
  378. IDHSetFormat                    (ComponentInstance      idh,
  379.                                  UInt32                 format)                             FIVEWORDINLINE(0x2F3C, 0x0004, 0x0013, 0x7000, 0xA82A);
  381. EXTERN_API( ComponentResult )
  382. IDHGetFormat                    (ComponentInstance      idh,
  383.                                  UInt32 *               format)                             FIVEWORDINLINE(0x2F3C, 0x0004, 0x0014, 0x7000, 0xA82A);
  386. #if OPAQUE_UPP_TYPES
  387.     EXTERN_API(IDHNotificationUPP)
  388.     NewIDHNotificationUPP          (IDHNotificationProcPtr  userRoutine);
  390.     EXTERN_API(void)
  391.     DisposeIDHNotificationUPP      (IDHNotificationUPP      userUPP);
  393.     EXTERN_API(OSStatus)
  394.     InvokeIDHNotificationUPP       (IDHGenericEvent *       event,
  395.                                     void *                  userData,
  396.                                     IDHNotificationUPP      userUPP);
  398. #else
  399.     #define NewIDHNotificationUPP(userRoutine)                      (userRoutine)
  400.     #define DisposeIDHNotificationUPP(userUPP)                      
  401.     #define InvokeIDHNotificationUPP(event, userData, userUPP)      (*userUPP)(event, userData)
  402. #endif
  404. /* selectors for component calls */
  405. enum {
  406.     kIDHGetDeviceListSelect                    = 0x0001,
  407.     kIDHGetDeviceConfigurationSelect           = 0x0002,
  408.     kIDHSetDeviceConfigurationSelect           = 0x0003,
  409.     kIDHGetDeviceStatusSelect                  = 0x0004,
  410.     kIDHGetDeviceClockSelect                   = 0x0005,
  411.     kIDHOpenDeviceSelect                       = 0x0006,
  412.     kIDHCloseDeviceSelect                      = 0x0007,
  413.     kIDHReadSelect                             = 0x0008,
  414.     kIDHWriteSelect                            = 0x0009,
  415.     kIDHNewNotificationSelect                  = 0x000A,
  416.     kIDHNotifyMeWhenSelect                     = 0x000B,
  417.     kIDHCancelNotificationSelect               = 0x000C,
  418.     kIDHDisposeNotificationSelect              = 0x000D,
  419.     kIDHReleaseBufferSelect                    = 0x000E,
  420.     kIDHCancelPendingIOSelect                  = 0x000F,
  421.     kIDHGetDeviceControlSelect                 = 0x0010,
  422.     kIDHUpdateDeviceListSelect                 = 0x0011,
  423.     kIDHGetDeviceTimeSelect                    = 0x0012,
  424.     kIDHSetFormatSelect                        = 0x0013,
  425.     kIDHGetFormatSelect                        = 0x0014
  426. };
  429. #endif /* ifndef __ISOCHRONOUSDATAHANDLER_R__ */
  431. #if PRAGMA_STRUCT_ALIGN
  432.     #pragma options align=reset
  433. #elif PRAGMA_STRUCT_PACKPUSH
  434.     #pragma pack(pop)
  435. #elif PRAGMA_STRUCT_PACK
  436.     #pragma pack()
  437. #endif
  439. #ifdef PRAGMA_IMPORT_OFF
  440. #pragma import off
  441. #elif PRAGMA_IMPORT
  442. #pragma import reset
  443. #endif
  445. #ifdef __cplusplus
  446. }
  447. #endif
  449. #endif /* __ISOCHRONOUSDATAHANDLER__ */