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

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

多媒体编程

开发平台：

Visual C++

Components.h：源码内容
  1. /*
  2.      File:       Components.h
  3.  
  4.      Contains:   QuickTime Interfaces.
  5.  
  6.      Version:    Technology: QuickTime 6.0
  7.                  Release:    QuickTime 6.0.2
  8.  
  9.      Copyright:  (c) 1990-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. #ifndef __COMPONENTS__
  18. #define __COMPONENTS__
  20. #ifndef __MACERRORS__
  21. #include "MacErrors.h"
  22. #endif
  24. #ifndef __MACTYPES__
  25. #include "MacTypes.h"
  26. #endif
  28. #ifndef __MIXEDMODE__
  29. #include "MixedMode.h"
  30. #endif
  35. #if PRAGMA_ONCE
  36. #pragma once
  37. #endif
  39. #ifdef __cplusplus
  40. extern "C" {
  41. #endif
  43. #if PRAGMA_IMPORT
  44. #pragma import on
  45. #endif
  47. #if PRAGMA_STRUCT_ALIGN
  48.     #pragma options align=mac68k
  49. #elif PRAGMA_STRUCT_PACKPUSH
  50.     #pragma pack(push, 2)
  51. #elif PRAGMA_STRUCT_PACK
  52.     #pragma pack(2)
  53. #endif
  55. enum {
  56.     kAppleManufacturer          = FOUR_CHAR_CODE('appl'),       /* Apple supplied components */
  57.     kComponentResourceType      = FOUR_CHAR_CODE('thng'),       /* a components resource type */
  58.     kComponentAliasResourceType = FOUR_CHAR_CODE('thga')        /* component alias resource type */
  59. };
  61. enum {
  62.     kAnyComponentType           = 0,
  63.     kAnyComponentSubType        = 0,
  64.     kAnyComponentManufacturer   = 0,
  65.     kAnyComponentFlagsMask      = 0
  66. };
  68. enum {
  69.     cmpIsMissing                = 1L << 29,
  70.     cmpWantsRegisterMessage     = 1L << 31
  71. };
  73. enum {
  74.     kComponentOpenSelect        = -1,                           /* ComponentInstance for this open */
  75.     kComponentCloseSelect       = -2,                           /* ComponentInstance for this close */
  76.     kComponentCanDoSelect       = -3,                           /* selector # being queried */
  77.     kComponentVersionSelect     = -4,                           /* no params */
  78.     kComponentRegisterSelect    = -5,                           /* no params */
  79.     kComponentTargetSelect      = -6,                           /* ComponentInstance for top of call chain */
  80.     kComponentUnregisterSelect  = -7,                           /* no params */
  81.     kComponentGetMPWorkFunctionSelect = -8,                     /* some params */
  82.     kComponentExecuteWiredActionSelect = -9,                    /* QTAtomContainer actionContainer, QTAtom actionAtom, QTCustomActionTargetPtr target, QTEventRecordPtr event */
  83.     kComponentGetPublicResourceSelect = -10                     /* OSType resourceType, short resourceId, Handle *resource */
  84. };
  86. /* Component Resource Extension flags */
  87. enum {
  88.     componentDoAutoVersion      = (1 << 0),
  89.     componentWantsUnregister    = (1 << 1),
  90.     componentAutoVersionIncludeFlags = (1 << 2),
  91.     componentHasMultiplePlatforms = (1 << 3),
  92.     componentLoadResident       = (1 << 4)
  93. };
  97. /* Set Default Component flags */
  98. enum {
  99.     defaultComponentIdentical   = 0,
  100.     defaultComponentAnyFlags    = 1,
  101.     defaultComponentAnyManufacturer = 2,
  102.     defaultComponentAnySubType  = 4,
  103.     defaultComponentAnyFlagsAnyManufacturer = (defaultComponentAnyFlags + defaultComponentAnyManufacturer),
  104.     defaultComponentAnyFlagsAnyManufacturerAnySubType = (defaultComponentAnyFlags + defaultComponentAnyManufacturer + defaultComponentAnySubType)
  105. };
  107. /* RegisterComponentResource flags */
  108. enum {
  109.     registerComponentGlobal     = 1,
  110.     registerComponentNoDuplicates = 2,
  111.     registerComponentAfterExisting = 4,
  112.     registerComponentAliasesOnly = 8
  113. };
  117. struct ComponentDescription {
  118.     OSType                          componentType;              /* A unique 4-byte code indentifying the command set */
  119.     OSType                          componentSubType;           /* Particular flavor of this instance */
  120.     OSType                          componentManufacturer;      /* Vendor indentification */
  121.     unsigned long                   componentFlags;             /* 8 each for Component,Type,SubType,Manuf/revision */
  122.     unsigned long                   componentFlagsMask;         /* Mask for specifying which flags to consider in search, zero during registration */
  123. };
  124. typedef struct ComponentDescription     ComponentDescription;
  127. struct ResourceSpec {
  128.     OSType                          resType;                    /* 4-byte code    */
  129.     short                           resID;                      /*         */
  130. };
  131. typedef struct ResourceSpec             ResourceSpec;
  133. struct ComponentResource {
  134.     ComponentDescription            cd;                         /* Registration parameters */
  135.     ResourceSpec                    component;                  /* resource where Component code is found */
  136.     ResourceSpec                    componentName;              /* name string resource */
  137.     ResourceSpec                    componentInfo;              /* info string resource */
  138.     ResourceSpec                    componentIcon;              /* icon resource */
  139. };
  140. typedef struct ComponentResource        ComponentResource;
  141. typedef ComponentResource *             ComponentResourcePtr;
  142. typedef ComponentResourcePtr *          ComponentResourceHandle;
  144. struct ComponentPlatformInfo {
  145.     long                            componentFlags;             /* flags of Component */
  146.     ResourceSpec                    component;                  /* resource where Component code is found */
  147.     short                           platformType;               /* gestaltSysArchitecture result */
  148. };
  149. typedef struct ComponentPlatformInfo    ComponentPlatformInfo;
  151. struct ComponentResourceExtension {
  152.     long                            componentVersion;           /* version of Component */
  153.     long                            componentRegisterFlags;     /* flags for registration */
  154.     short                           componentIconFamily;        /* resource id of Icon Family */
  155. };
  156. typedef struct ComponentResourceExtension ComponentResourceExtension;
  158. struct ComponentPlatformInfoArray {
  159.     long                            count;
  160.     ComponentPlatformInfo           platformArray[1];
  161. };
  162. typedef struct ComponentPlatformInfoArray ComponentPlatformInfoArray;
  164. struct ExtComponentResource {
  165.     ComponentDescription            cd;                         /* registration parameters */
  166.     ResourceSpec                    component;                  /* resource where Component code is found */
  167.     ResourceSpec                    componentName;              /* name string resource */
  168.     ResourceSpec                    componentInfo;              /* info string resource */
  169.     ResourceSpec                    componentIcon;              /* icon resource */
  170.     long                            componentVersion;           /* version of Component */
  171.     long                            componentRegisterFlags;     /* flags for registration */
  172.     short                           componentIconFamily;        /* resource id of Icon Family */
  173.     long                            count;                      /* elements in platformArray */
  174.     ComponentPlatformInfo           platformArray[1];
  175. };
  176. typedef struct ExtComponentResource     ExtComponentResource;
  177. typedef ExtComponentResource *          ExtComponentResourcePtr;
  178. typedef ExtComponentResourcePtr *       ExtComponentResourceHandle;
  180. struct ComponentAliasResource {
  181.     ComponentResource               cr;                         /* Registration parameters */
  182.     ComponentDescription            aliasCD;                    /* component alias description */
  183. };
  184. typedef struct ComponentAliasResource   ComponentAliasResource;
  185. /*  Structure received by Component:        */
  187. struct ComponentParameters {
  188.     UInt8                           flags;                      /* call modifiers: sync/async, deferred, immed, etc */
  189.     UInt8                           paramSize;                  /* size in bytes of actual parameters passed to this call */
  190.     short                           what;                       /* routine selector, negative for Component management calls */
  191.     long                            params[1];                  /* actual parameters for the indicated routine */
  192. };
  193. typedef struct ComponentParameters      ComponentParameters;
  195. struct ComponentRecord {
  196.     long                            data[1];
  197. };
  198. typedef struct ComponentRecord          ComponentRecord;
  200. typedef ComponentRecord *               Component;
  202. struct ComponentInstanceRecord {
  203.     long                            data[1];
  204. };
  205. typedef struct ComponentInstanceRecord  ComponentInstanceRecord;
  207. typedef ComponentInstanceRecord *       ComponentInstance;
  209. struct RegisteredComponentRecord {
  210.     long                            data[1];
  211. };
  212. typedef struct RegisteredComponentRecord RegisteredComponentRecord;
  213. typedef RegisteredComponentRecord *     RegisteredComponentRecordPtr;
  215. typedef RegisteredComponentRecord *     RegisteredComponentPtr;
  217. struct RegisteredComponentInstanceRecord {
  218.     long                            data[1];
  219. };
  220. typedef struct RegisteredComponentInstanceRecord RegisteredComponentInstanceRecord;
  221. typedef RegisteredComponentInstanceRecord * RegisteredComponentInstanceRecordPtr;
  223. typedef RegisteredComponentInstanceRecord * RegisteredComponentInstancePtr;
  224. typedef long                            ComponentResult;
  225. enum {
  226.     platform68k                 = 1,                            /* platform type (response from gestaltComponentPlatform) */
  227.     platformPowerPC             = 2,                            /* (when gestaltComponentPlatform is not implemented, use */
  228.     platformInterpreted         = 3,                            /* gestaltSysArchitecture) */
  229.     platformWin32               = 4,
  230.     platformPowerPCNativeEntryPoint = 5
  231. };
  233. enum {
  234.     mpWorkFlagDoWork            = (1 << 0),
  235.     mpWorkFlagDoCompletion      = (1 << 1),
  236.     mpWorkFlagCopyWorkBlock     = (1 << 2),
  237.     mpWorkFlagDontBlock         = (1 << 3),
  238.     mpWorkFlagGetProcessorCount = (1 << 4),
  239.     mpWorkFlagGetIsRunning      = (1 << 6)
  240. };
  242. enum {
  243.     cmpAliasNoFlags             = 0,
  244.     cmpAliasOnlyThisFile        = 1
  245. };
  248. struct ComponentMPWorkFunctionHeaderRecord {
  249.     UInt32                          headerSize;
  250.     UInt32                          recordSize;
  251.     UInt32                          workFlags;
  252.     UInt16                          processorCount;
  253.     UInt8                           unused;
  254.     UInt8                           isRunning;
  255. };
  256. typedef struct ComponentMPWorkFunctionHeaderRecord ComponentMPWorkFunctionHeaderRecord;
  257. typedef ComponentMPWorkFunctionHeaderRecord * ComponentMPWorkFunctionHeaderRecordPtr;
  258. typedef CALLBACK_API( ComponentResult , ComponentMPWorkFunctionProcPtr )(void *globalRefCon, ComponentMPWorkFunctionHeaderRecordPtr header);
  259. typedef CALLBACK_API( ComponentResult , ComponentRoutineProcPtr )(ComponentParameters *cp, Handle componentStorage);
  260. typedef CALLBACK_API( OSErr , GetMissingComponentResourceProcPtr )(Component c, OSType resType, short resID, void *refCon, Handle *resource);
  261. typedef STACK_UPP_TYPE(ComponentMPWorkFunctionProcPtr)          ComponentMPWorkFunctionUPP;
  262. typedef STACK_UPP_TYPE(ComponentRoutineProcPtr)                 ComponentRoutineUPP;
  263. typedef STACK_UPP_TYPE(GetMissingComponentResourceProcPtr)      GetMissingComponentResourceUPP;
  264. /*
  265.     The parameter list for each ComponentFunction is unique. It is
  266.     therefore up to users to create the appropriate procInfo for their
  267.     own ComponentFunctions where necessary.
  268. */
  270. typedef UniversalProcPtr                ComponentFunctionUPP;
  271. /*
  272.     For Carbon, we add NewComponentFunctionUPP and DisposeComponentFunctionUPP
  273.     calls that take a procInfo as their second parameter. This allows native
  274.     Component writers to easily write a Carbon compliant component. Note that
  275.     there is no InvokeComponentFunctionUPP, use the CallComponentFunction calls
  276.     with the UPP instead.
  277. */
  279. #if OPAQUE_UPP_TYPES
  280. EXTERN_API( ComponentFunctionUPP )
  281. NewComponentFunctionUPP         (ProcPtr                userRoutine,
  282.                                  ProcInfoType           procInfo);
  284. EXTERN_API( void )
  285. DisposeComponentFunctionUPP     (ComponentFunctionUPP   userUPP);
  287. #else
  288. #define NewComponentFunctionUPP(userRoutine,procInfo)       (ComponentFunctionUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), (ProcInfoType)procInfo, GetCurrentArchitecture())
  289. #define DisposeComponentFunctionUPP(userUPP)                DisposeRoutineDescriptor(userUPP)
  290. #endif  /* OPAQUE_UPP_TYPES */
  292. #if TARGET_RT_MAC_CFM
  293. /* 
  294.     CallComponentUPP is a global variable exported from InterfaceLib.
  295.     It is the ProcPtr passed to CallUniversalProc to manually call a component function.
  296. */
  297. extern UniversalProcPtr CallComponentUPP;
  298. #endif
  300. #define ComponentCallNow( callNumber, paramSize ) 
  301.     FIVEWORDINLINE( 0x2F3C,paramSize,callNumber,0x7000,0xA82A )
  303. /********************************************************
  304. *                                                       *
  305. *               APPLICATION LEVEL CALLS                 *
  306. *                                                       *
  307. ********************************************************/
  308. /********************************************************
  309. * Component Database Add, Delete, and Query Routines
  310. ********************************************************/
  311. EXTERN_API( Component )
  312. RegisterComponent               (ComponentDescription * cd,
  313.                                  ComponentRoutineUPP    componentEntryPoint,
  314.                                  short                  global,
  315.                                  Handle                 componentName,
  316.                                  Handle                 componentInfo,
  317.                                  Handle                 componentIcon)                      TWOWORDINLINE(0x7001, 0xA82A);
  319. EXTERN_API( Component )
  320. RegisterComponentResource       (ComponentResourceHandle  cr,
  321.                                  short                  global)                             TWOWORDINLINE(0x7012, 0xA82A);
  323. EXTERN_API( OSErr )
  324. UnregisterComponent             (Component              aComponent)                         TWOWORDINLINE(0x7002, 0xA82A);
  326. EXTERN_API( Component )
  327. FindNextComponent               (Component              aComponent,
  328.                                  ComponentDescription * looking)                            TWOWORDINLINE(0x7004, 0xA82A);
  330. EXTERN_API( long )
  331. CountComponents                 (ComponentDescription * looking)                            TWOWORDINLINE(0x7003, 0xA82A);
  333. EXTERN_API( OSErr )
  334. GetComponentInfo                (Component              aComponent,
  335.                                  ComponentDescription * cd,
  336.                                  Handle                 componentName,
  337.                                  Handle                 componentInfo,
  338.                                  Handle                 componentIcon)                      TWOWORDINLINE(0x7005, 0xA82A);
  340. EXTERN_API( long )
  341. GetComponentListModSeed         (void)                                                      TWOWORDINLINE(0x7006, 0xA82A);
  343. EXTERN_API( long )
  344. GetComponentTypeModSeed         (OSType                 componentType)                      TWOWORDINLINE(0x702C, 0xA82A);
  346. /********************************************************
  347. * Component Instance Allocation and dispatch routines
  348. ********************************************************/
  349. EXTERN_API( OSErr )
  350. OpenAComponent                  (Component              aComponent,
  351.                                  ComponentInstance *    ci)                                 TWOWORDINLINE(0x702D, 0xA82A);
  353. EXTERN_API( ComponentInstance )
  354. OpenComponent                   (Component              aComponent)                         TWOWORDINLINE(0x7007, 0xA82A);
  356. EXTERN_API( OSErr )
  357. CloseComponent                  (ComponentInstance      aComponentInstance)                 TWOWORDINLINE(0x7008, 0xA82A);
  359. EXTERN_API( OSErr )
  360. GetComponentInstanceError       (ComponentInstance      aComponentInstance)                 TWOWORDINLINE(0x700A, 0xA82A);
  362. /********************************************************
  363. * Component aliases
  364. ********************************************************/
  365. EXTERN_API( Component )
  366. ResolveComponentAlias           (Component              aComponent)                         TWOWORDINLINE(0x7020, 0xA82A);
  368. /********************************************************
  369. * Component public resources and public string lists
  370. ********************************************************/
  371. /* Note: GetComponentPublicResource returns a Handle, not a resource.  The caller must dispose it with DisposeHandle. */
  372. EXTERN_API( OSErr )
  373. GetComponentPublicResource      (Component              aComponent,
  374.                                  OSType                 resourceType,
  375.                                  short                  resourceID,
  376.                                  Handle *               theResource)                        TWOWORDINLINE(0x7038, 0xA82A);
  378. EXTERN_API( OSErr )
  379. GetComponentPublicResourceList  (OSType                 resourceType,
  380.                                  short                  resourceID,
  381.                                  long                   flags,
  382.                                  ComponentDescription * cd,
  383.                                  GetMissingComponentResourceUPP  missingProc,
  384.                                  void *                 refCon,
  385.                                  void *                 atomContainerPtr)                   TWOWORDINLINE(0x7039, 0xA82A);
  387. EXTERN_API( OSErr )
  388. GetComponentPublicIndString     (Component              aComponent,
  389.                                  Str255                 theString,
  390.                                  short                  strListID,
  391.                                  short                  index)                              TWOWORDINLINE(0x703A, 0xA82A);
  393. /********************************************************
  394. *                                                       *
  395. *                   CALLS MADE BY COMPONENTS            *
  396. *                                                       *
  397. ********************************************************/
  398. /********************************************************
  399. * Component Management routines
  400. ********************************************************/
  401. EXTERN_API( void )
  402. SetComponentInstanceError       (ComponentInstance      aComponentInstance,
  403.                                  OSErr                  theError)                           TWOWORDINLINE(0x700B, 0xA82A);
  405. EXTERN_API( long )
  406. GetComponentRefcon              (Component              aComponent)                         TWOWORDINLINE(0x7010, 0xA82A);
  408. EXTERN_API( void )
  409. SetComponentRefcon              (Component              aComponent,
  410.                                  long                   theRefcon)                          TWOWORDINLINE(0x7011, 0xA82A);
  412. EXTERN_API( short )
  413. OpenComponentResFile            (Component              aComponent)                         TWOWORDINLINE(0x7015, 0xA82A);
  415. EXTERN_API( OSErr )
  416. OpenAComponentResFile           (Component              aComponent,
  417.                                  short *                resRef)                             TWOWORDINLINE(0x702F, 0xA82A);
  419. EXTERN_API( OSErr )
  420. CloseComponentResFile           (short                  refnum)                             TWOWORDINLINE(0x7018, 0xA82A);
  422. /* Note: GetComponentResource returns a Handle, not a resource.  The caller must dispose it with DisposeHandle. */
  423. EXTERN_API( OSErr )
  424. GetComponentResource            (Component              aComponent,
  425.                                  OSType                 resType,
  426.                                  short                  resID,
  427.                                  Handle *               theResource)                        TWOWORDINLINE(0x7035, 0xA82A);
  429. EXTERN_API( OSErr )
  430. GetComponentIndString           (Component              aComponent,
  431.                                  Str255                 theString,
  432.                                  short                  strListID,
  433.                                  short                  index)                              TWOWORDINLINE(0x7036, 0xA82A);
  435. /********************************************************
  436. * Component Instance Management routines
  437. ********************************************************/
  438. EXTERN_API( Handle )
  439. GetComponentInstanceStorage     (ComponentInstance      aComponentInstance)                 TWOWORDINLINE(0x700C, 0xA82A);
  441. EXTERN_API( void )
  442. SetComponentInstanceStorage     (ComponentInstance      aComponentInstance,
  443.                                  Handle                 theStorage)                         TWOWORDINLINE(0x700D, 0xA82A);
  445. EXTERN_API( long )
  446. GetComponentInstanceA5          (ComponentInstance      aComponentInstance)                 TWOWORDINLINE(0x700E, 0xA82A);
  448. EXTERN_API( void )
  449. SetComponentInstanceA5          (ComponentInstance      aComponentInstance,
  450.                                  long                   theA5)                              TWOWORDINLINE(0x700F, 0xA82A);
  452. EXTERN_API( long )
  453. CountComponentInstances         (Component              aComponent)                         TWOWORDINLINE(0x7013, 0xA82A);
  455. /* useful helper routines for convenient method dispatching */
  456. EXTERN_API( long )
  457. CallComponentFunction           (ComponentParameters *  params,
  458.                                  ComponentFunctionUPP   func)                               TWOWORDINLINE(0x70FF, 0xA82A);
  460. EXTERN_API( long )
  461. CallComponentFunctionWithStorage (Handle                storage,
  462.                                  ComponentParameters *  params,
  463.                                  ComponentFunctionUPP   func)                               TWOWORDINLINE(0x70FF, 0xA82A);
  465. #if TARGET_OS_MAC
  466. EXTERN_API( long )
  467. CallComponentFunctionWithStorageProcInfo (Handle        storage,
  468.                                  ComponentParameters *  params,
  469.                                  ProcPtr                func,
  470.                                  ProcInfoType           funcProcInfo);
  472. #else
  473. #define CallComponentFunctionWithStorageProcInfo(storage, params, func, funcProcInfo ) CallComponentFunctionWithStorage(storage, params, func)
  475. #endif  /* TARGET_OS_MAC */
  477. EXTERN_API( long )
  478. DelegateComponentCall           (ComponentParameters *  originalParams,
  479.                                  ComponentInstance      ci)                                 TWOWORDINLINE(0x7024, 0xA82A);
  481. EXTERN_API( OSErr )
  482. SetDefaultComponent             (Component              aComponent,
  483.                                  short                  flags)                              TWOWORDINLINE(0x701E, 0xA82A);
  485. EXTERN_API( ComponentInstance )
  486. OpenDefaultComponent            (OSType                 componentType,
  487.                                  OSType                 componentSubType)                   TWOWORDINLINE(0x7021, 0xA82A);
  489. EXTERN_API( OSErr )
  490. OpenADefaultComponent           (OSType                 componentType,
  491.                                  OSType                 componentSubType,
  492.                                  ComponentInstance *    ci)                                 TWOWORDINLINE(0x702E, 0xA82A);
  494. EXTERN_API( Component )
  495. CaptureComponent                (Component              capturedComponent,
  496.                                  Component              capturingComponent)                 TWOWORDINLINE(0x701C, 0xA82A);
  498. EXTERN_API( OSErr )
  499. UncaptureComponent              (Component              aComponent)                         TWOWORDINLINE(0x701D, 0xA82A);
  501. EXTERN_API( long )
  502. RegisterComponentResourceFile   (short                  resRefNum,
  503.                                  short                  global)                             TWOWORDINLINE(0x7014, 0xA82A);
  505. EXTERN_API( OSErr )
  506. GetComponentIconSuite           (Component              aComponent,
  507.                                  Handle *               iconSuite)                          TWOWORDINLINE(0x7029, 0xA82A);
  510. /********************************************************
  511. *                                                       *
  512. *           Direct calls to the Components              *
  513. *                                                       *
  514. ********************************************************/
  515. /* Old style names*/
  517. EXTERN_API( long )
  518. ComponentFunctionImplemented    (ComponentInstance      ci,
  519.                                  short                  ftnNumber)                          FIVEWORDINLINE(0x2F3C, 0x0002, 0xFFFD, 0x7000, 0xA82A);
  521. EXTERN_API( long )
  522. GetComponentVersion             (ComponentInstance      ci)                                 FIVEWORDINLINE(0x2F3C, 0x0000, 0xFFFC, 0x7000, 0xA82A);
  524. EXTERN_API( long )
  525. ComponentSetTarget              (ComponentInstance      ci,
  526.                                  ComponentInstance      target)                             FIVEWORDINLINE(0x2F3C, 0x0004, 0xFFFA, 0x7000, 0xA82A);
  528. /* New style names*/
  530. EXTERN_API( ComponentResult )
  531. CallComponentOpen               (ComponentInstance      ci,
  532.                                  ComponentInstance      self)                               FIVEWORDINLINE(0x2F3C, 0x0004, 0xFFFF, 0x7000, 0xA82A);
  534. EXTERN_API( ComponentResult )
  535. CallComponentClose              (ComponentInstance      ci,
  536.                                  ComponentInstance      self)                               FIVEWORDINLINE(0x2F3C, 0x0004, 0xFFFE, 0x7000, 0xA82A);
  538. EXTERN_API( ComponentResult )
  539. CallComponentCanDo              (ComponentInstance      ci,
  540.                                  short                  ftnNumber)                          FIVEWORDINLINE(0x2F3C, 0x0002, 0xFFFD, 0x7000, 0xA82A);
  542. EXTERN_API( ComponentResult )
  543. CallComponentVersion            (ComponentInstance      ci)                                 FIVEWORDINLINE(0x2F3C, 0x0000, 0xFFFC, 0x7000, 0xA82A);
  545. EXTERN_API( ComponentResult )
  546. CallComponentRegister           (ComponentInstance      ci)                                 FIVEWORDINLINE(0x2F3C, 0x0000, 0xFFFB, 0x7000, 0xA82A);
  548. EXTERN_API( ComponentResult )
  549. CallComponentTarget             (ComponentInstance      ci,
  550.                                  ComponentInstance      target)                             FIVEWORDINLINE(0x2F3C, 0x0004, 0xFFFA, 0x7000, 0xA82A);
  552. EXTERN_API( ComponentResult )
  553. CallComponentUnregister         (ComponentInstance      ci)                                 FIVEWORDINLINE(0x2F3C, 0x0000, 0xFFF9, 0x7000, 0xA82A);
  555. EXTERN_API( ComponentResult )
  556. CallComponentGetMPWorkFunction  (ComponentInstance      ci,
  557.                                  ComponentMPWorkFunctionUPP * workFunction,
  558.                                  void **                refCon)                             FIVEWORDINLINE(0x2F3C, 0x0008, 0xFFF8, 0x7000, 0xA82A);
  560. EXTERN_API( ComponentResult )
  561. CallComponentGetPublicResource  (ComponentInstance      ci,
  562.                                  OSType                 resourceType,
  563.                                  short                  resourceID,
  564.                                  Handle *               resource)                           FIVEWORDINLINE(0x2F3C, 0x000A, 0xFFF6, 0x7000, 0xA82A);
  567. #if !TARGET_OS_MAC
  568. /* 
  569.         CallComponent is used by ComponentGlue routines to manually call a component function.
  570.      */
  571. EXTERN_API( ComponentResult )
  572. CallComponent                   (ComponentInstance      ci,
  573.                                  ComponentParameters *  cp);
  575. #endif  /* !TARGET_OS_MAC */
  577. /*
  578.     CallComponentDispatch is a CarbonLib routine that replaces CallComponent inline glue
  579.     to call a component function.
  580.  */
  581. EXTERN_API( ComponentResult )
  582. CallComponentDispatch           (ComponentParameters *  cp);
  585. /* UPP call backs */
  586. #if OPAQUE_UPP_TYPES
  587.     EXTERN_API(ComponentMPWorkFunctionUPP)
  588.     NewComponentMPWorkFunctionUPP    (ComponentMPWorkFunctionProcPtr userRoutine);
  590.     EXTERN_API(ComponentRoutineUPP)
  591.     NewComponentRoutineUPP         (ComponentRoutineProcPtr userRoutine);
  593.     EXTERN_API(GetMissingComponentResourceUPP)
  594.     NewGetMissingComponentResourceUPP    (GetMissingComponentResourceProcPtr userRoutine);
  596.     EXTERN_API(void)
  597.     DisposeComponentMPWorkFunctionUPP    (ComponentMPWorkFunctionUPP userUPP);
  599.     EXTERN_API(void)
  600.     DisposeComponentRoutineUPP     (ComponentRoutineUPP     userUPP);
  602.     EXTERN_API(void)
  603.     DisposeGetMissingComponentResourceUPP    (GetMissingComponentResourceUPP userUPP);
  605.     EXTERN_API(ComponentResult)
  606.     InvokeComponentMPWorkFunctionUPP    (void *             globalRefCon,
  607.                                     ComponentMPWorkFunctionHeaderRecordPtr header,
  608.                                     ComponentMPWorkFunctionUPP userUPP);
  610.     EXTERN_API(ComponentResult)
  611.     InvokeComponentRoutineUPP      (ComponentParameters *   cp,
  612.                                     Handle                  componentStorage,
  613.                                     ComponentRoutineUPP     userUPP);
  615.     EXTERN_API(OSErr)
  616.     InvokeGetMissingComponentResourceUPP    (Component      c,
  617.                                     OSType                  resType,
  618.                                     short                   resID,
  619.                                     void *                  refCon,
  620.                                     Handle *                resource,
  621.                                     GetMissingComponentResourceUPP userUPP);
  623. #else
  624.     enum { uppComponentMPWorkFunctionProcInfo = 0x000003F0 };       /* pascal 4_bytes Func(4_bytes, 4_bytes) */
  625.     enum { uppComponentRoutineProcInfo = 0x000003F0 };              /* pascal 4_bytes Func(4_bytes, 4_bytes) */
  626.     enum { uppGetMissingComponentResourceProcInfo = 0x0000FBE0 };   /* pascal 2_bytes Func(4_bytes, 4_bytes, 2_bytes, 4_bytes, 4_bytes) */
  627.     #define NewComponentMPWorkFunctionUPP(userRoutine)              (ComponentMPWorkFunctionUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppComponentMPWorkFunctionProcInfo, GetCurrentArchitecture())
  628.     #define NewComponentRoutineUPP(userRoutine)                     (ComponentRoutineUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppComponentRoutineProcInfo, GetCurrentArchitecture())
  629.     #define NewGetMissingComponentResourceUPP(userRoutine)          (GetMissingComponentResourceUPP)NewRoutineDescriptor((ProcPtr)(userRoutine), uppGetMissingComponentResourceProcInfo, GetCurrentArchitecture())
  630.     #define DisposeComponentMPWorkFunctionUPP(userUPP)              DisposeRoutineDescriptor(userUPP)
  631.     #define DisposeComponentRoutineUPP(userUPP)                     DisposeRoutineDescriptor(userUPP)
  632.     #define DisposeGetMissingComponentResourceUPP(userUPP)          DisposeRoutineDescriptor(userUPP)
  633.     #define InvokeComponentMPWorkFunctionUPP(globalRefCon, header, userUPP)  (ComponentResult)CALL_TWO_PARAMETER_UPP((userUPP), uppComponentMPWorkFunctionProcInfo, (globalRefCon), (header))
  634.     #define InvokeComponentRoutineUPP(cp, componentStorage, userUPP)  (ComponentResult)CALL_TWO_PARAMETER_UPP((userUPP), uppComponentRoutineProcInfo, (cp), (componentStorage))
  635.     #define InvokeGetMissingComponentResourceUPP(c, resType, resID, refCon, resource, userUPP)  (OSErr)CALL_FIVE_PARAMETER_UPP((userUPP), uppGetMissingComponentResourceProcInfo, (c), (resType), (resID), (refCon), (resource))
  636. #endif
  637. /* support for pre-Carbon UPP routines: NewXXXProc and CallXXXProc */
  638. #define NewComponentMPWorkFunctionProc(userRoutine)             NewComponentMPWorkFunctionUPP(userRoutine)
  639. #define NewComponentRoutineProc(userRoutine)                    NewComponentRoutineUPP(userRoutine)
  640. #define NewGetMissingComponentResourceProc(userRoutine)         NewGetMissingComponentResourceUPP(userRoutine)
  641. #define CallComponentMPWorkFunctionProc(userRoutine, globalRefCon, header) InvokeComponentMPWorkFunctionUPP(globalRefCon, header, userRoutine)
  642. #define CallComponentRoutineProc(userRoutine, cp, componentStorage) InvokeComponentRoutineUPP(cp, componentStorage, userRoutine)
  643. #define CallGetMissingComponentResourceProc(userRoutine, c, resType, resID, refCon, resource) InvokeGetMissingComponentResourceUPP(c, resType, resID, refCon, resource, userRoutine)
  644. /* ProcInfos */
  646. /* MixedMode ProcInfo constants for component calls */
  647. enum {
  648.     uppComponentFunctionImplementedProcInfo    = 0x000002F0,
  649.     uppGetComponentVersionProcInfo             = 0x000000F0,
  650.     uppComponentSetTargetProcInfo              = 0x000003F0,
  651.     uppCallComponentOpenProcInfo               = 0x000003F0,
  652.     uppCallComponentCloseProcInfo              = 0x000003F0,
  653.     uppCallComponentCanDoProcInfo              = 0x000002F0,
  654.     uppCallComponentVersionProcInfo            = 0x000000F0,
  655.     uppCallComponentRegisterProcInfo           = 0x000000F0,
  656.     uppCallComponentTargetProcInfo             = 0x000003F0,
  657.     uppCallComponentUnregisterProcInfo         = 0x000000F0,
  658.     uppCallComponentGetMPWorkFunctionProcInfo  = 0x00000FF0,
  659.     uppCallComponentGetPublicResourceProcInfo  = 0x00003BF0
  660. };
  668. #if PRAGMA_STRUCT_ALIGN
  669.     #pragma options align=reset
  670. #elif PRAGMA_STRUCT_PACKPUSH
  671.     #pragma pack(pop)
  672. #elif PRAGMA_STRUCT_PACK
  673.     #pragma pack()
  674. #endif
  676. #ifdef PRAGMA_IMPORT_OFF
  677. #pragma import off
  678. #elif PRAGMA_IMPORT
  679. #pragma import reset
  680. #endif
  682. #ifdef __cplusplus
  683. }
  684. #endif
  686. #endif /* __COMPONENTS__ */