/*
     File:       PMIOModule.h
 
     Contains:   Mac OS X Printing Manager IO Module Interfaces.
 
     Version:    QuickTime 7.1
 
     Copyright:  © 2006 © 1999-2001 by Apple Computer, Inc., all rights reserved
 
     Bugs?:      For bug reports, consult the following page on
                 the World Wide Web:
 
                     http://developer.apple.com/bugreporter/
 
*/
#ifndef __CFSTRING__
#include <CFString.h>
#endif

#ifndef __PMTICKET__
#include <PMTicket.h>
#endif

#ifndef __PMPLUGINHEADER__
#include <PMPluginHeader.h>
#endif

#ifndef __PMERRORS__
#include <PMErrors.h>
#endif



/* context ID for IO Modules */


#if PRAGMA_ONCE
#pragma once
#endif

#ifdef __cplusplus
extern "C" {
#endif

#if PRAGMA_IMPORT
#pragma import on
#endif

#if PRAGMA_STRUCT_ALIGN
    #pragma options align=mac68k
#elif PRAGMA_STRUCT_PACKPUSH
    #pragma pack(push, 2)
#elif PRAGMA_STRUCT_PACK
    #pragma pack(2)
#endif

typedef struct OpaqueIOMContext*        IOMContext;
/* kPMPrinterURI corresponds to a CFString to a connection-specific 
address specification for the printer. For instance, on an lpd connection  
this would be an address of the form lpd://<host>/<queue name>. */
#define kPMPrinterURI                   CFSTR("Printer URI")
/* System-supported connection type names used in identifying the different connection types
and for requesting lookup information from Printer Modules. PrintCenter does not use these 
strings in its UI, instead it gets the actual UI strings from the Printer Browser Module. */
#define kPMAppleTalkConnection          CFSTR("AppleTalk")
#define kPMUSBConnection                CFSTR("USB")
#define kPMLPRConnection                CFSTR("LPR")
#define kPMDirServicesConnection        CFSTR("Directory Services")
/* possible attributes that can be requested from an IO Module and allow clients to determine various 
characteristics about the IOM, its connection type, and the target printer.  The same attribute can 
be used for getting a value or setting it. */
#define kPMBiDiAttr                     CFSTR("Supports BiDirectional Communication")
/* bi-directional communication capability */
#define kPM8BitChannelAttr              CFSTR("Supports 8-bit Channel")
/* full 8-bit per byte data (vs. 7) */
#define kPMTransparentByteRange         CFSTR("Supports Transparent Byte Range")
/* transparent byte range */
#define kPMJobIDAttr                    CFSTR("Supports JobID")
/* in-printer-jobID */
#define kPMTimeoutAttr                  CFSTR("Supports Timeout")
/* get/set timeout duration */
#define kPMTStatusAttr                  CFSTR("Supports T Status Request")
/* status on the T channel */
/* Used with the IOMGetAttribute call, a supporting IO Module will hand back
 * a copy of a CFStringRef describing the last error encountered. If there was
 * no last error, or if there is no available string then NULL is passed back.
 */
#define kPMLastErrorStrAttr             CFSTR("Last Error")

/* Type ID, interface ID for the IOM CFPlugin */
#define kIOModuleTypeIDStr              "EE5A5E5C-C2DD-11D3-84B5-00050209D9C1"
#define kIOModuleIntfIDStr              "F4F7510C-C2DD-11D3-93A5-00050209D9C1"
/* IOM API version numbers (see PMPluginHeader.h for the meaning of these defintions) */
enum {
  kIOMBuildVersionMajor         = 1,
  kIOMBuildVersionMinor         = 0,
  kIOMBaseVersionMajor          = 1,
  kIOMBaseVersionMinor          = 0
};

typedef CALLBACK_API_C( OSStatus , PMIOModuleGetConnectionInfoProc )(CFStringRef *connectionType, CFStringRef *pbmPath);
typedef CALLBACK_API_C( OSStatus , PMIOModuleInitializeProc )(CFDataRef printerAddress, IOMContext *ioModuleContextPtr);
typedef CALLBACK_API_C( OSStatus , PMIOModuleOpenProc )(IOMContext ioModuleContext, PMTicketRef jobTicket, UInt32 *bufferSize);
typedef CALLBACK_API_C( OSStatus , PMIOModuleReadProc )(IOMContext ioModuleContext, Ptr buffer, UInt32 *size, Boolean *eoj);
typedef CALLBACK_API_C( OSStatus , PMIOModuleWriteProc )(IOMContext ioModuleContext, Ptr buffer, UInt32 *size, Boolean eoj);
typedef CALLBACK_API_C( OSStatus , PMIOModuleStatusProc )(IOMContext ioModuleContext, CFStringRef *status);
typedef CALLBACK_API_C( OSStatus , PMIOModuleGetAttributeProc )(IOMContext ioModuleContext, CFStringRef attribute, CFTypeRef *result);
typedef CALLBACK_API_C( OSStatus , PMIOModuleSetAttributeProc )(IOMContext ioModuleContext, CFStringRef attribute, CFTypeRef data);
typedef CALLBACK_API_C( OSStatus , PMIOModuleCloseProc )(IOMContext ioModuleContext, Boolean abort);
typedef CALLBACK_API_C( OSStatus , PMIOModuleTerminateProc )(IOMContext * ioModuleContextPtr);
/* IOMProcs contains the routines required to be exported by an IOM Module. */
struct IOMProcs {
                                              /* The plugin header is required with all plugins and must proceed object's layout.*/
  PMPlugInHeader      pluginHeader;

                                              /* The actual IO Module routine Procs*/

                                              /* GetConnectionInfo: returns the connection type and the path to the companion browser module relative */
                                              /* to /Library/Printers/.  The connection types: AppleTalk, USB, LPR, and Directory Services are reserved by Apple.*/
  PMIOModuleGetConnectionInfoProc  GetConnectionInfo;

                                              /* Initialize: creates a context to store local variables during an IO session.  printerAddress of*/
                                              /* the target printer is passed as CFDataRef as defined by the protocol and set by the Printer Browser Module*/
  PMIOModuleInitializeProc  Initialize;

                                              /* Open: open IO connection with the target device.  The parameter buffSize is set*/
                                              /* by the IOM to return its maximum write buffer size.*/
  PMIOModuleOpenProc  Open;

                                              /* Read: read data from the device over the read channel, if any.  */
  PMIOModuleReadProc  Read;

                                              /* Write: write data to the device*/
  PMIOModuleWriteProc  Write;

                                              /* Status: get status from the device*/
  PMIOModuleStatusProc  Status;

                                              /* GetAttribute: checks if a defined IO attribute is supported by the target IO connection.  If the requested */
                                              /* 'attribute' is supported and available, it's returned in 'result'.  If supported but not available, error code */
                                              /* kAttrNotAvailable is returned.  If the attribute is not supported, kPMNotImplemented is returned.*/
  PMIOModuleGetAttributeProc  GetAttribute;

                                              /* SetAttribute: sets a pre-defined 'attribute' to a given value passed in 'data'.  Only supported attributes*/
                                              /* can be set; otherwise kAttrNotAvailable or kPMNotImplemented is returned.*/
  PMIOModuleSetAttributeProc  SetAttribute;

                                              /* Close: close IO connection with the target device.  The parameter 'abort' indicates whether the current job*/
                                              /* is to be canceled before closing connection (true; i.e. user cancels) or not (false; i.e. normal job completion).*/
  PMIOModuleCloseProc  Close;

                                              /* Terminate: dispose of any data allocated in Initialize.*/
  PMIOModuleTerminateProc  Terminate;

};
typedef struct IOMProcs                 IOMProcs;
/* IOM interface is an object containing addresses to the module's entry points:*/
struct IOMInterface {
  const IOMProcs *    vtable;
};
typedef struct IOMInterface             IOMInterface;
typedef const IOMInterface *            IOMInterfaceRef;

#if PRAGMA_STRUCT_ALIGN
    #pragma options align=reset
#elif PRAGMA_STRUCT_PACKPUSH
    #pragma pack(pop)
#elif PRAGMA_STRUCT_PACK
    #pragma pack()
#endif

#ifdef PRAGMA_IMPORT_OFF
#pragma import off
#elif PRAGMA_IMPORT
#pragma import reset
#endif

#ifdef __cplusplus
}
#endif
