1/* 2 * Copyright (c) 2014 Apple Inc. All rights reserved. 3 * 4 * @APPLE_LICENSE_HEADER_START@ 5 * 6 * This file contains Original Code and/or Modifications of Original Code 7 * as defined in and that are subject to the Apple Public Source License 8 * Version 2.0 (the 'License'). You may not use this file except in 9 * compliance with the License. Please obtain a copy of the License at 10 * http://www.opensource.apple.com/apsl/ and read it before using this 11 * file. 12 * 13 * The Original Code and all software distributed under the License are 14 * distributed on an 'AS IS' basis, WITHOUT WARRANTY OF ANY KIND, EITHER 15 * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES, 16 * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY, 17 * FITNESS FOR A PARTICULAR PURPOSE, QUIET ENJOYMENT OR NON-INFRINGEMENT. 18 * Please see the License for the specific language governing rights and 19 * limitations under the License. 20 * 21 * @APPLE_LICENSE_HEADER_END@ 22 */ 23 24/* CFMessagePort.h 25 Copyright (c) 1998-2013, Apple Inc. All rights reserved. 26*/ 27 28#if !defined(__COREFOUNDATION_CFMESSAGEPORT__) 29#define __COREFOUNDATION_CFMESSAGEPORT__ 1 30 31#include <CoreFoundation/CFString.h> 32#include <CoreFoundation/CFRunLoop.h> 33#include <CoreFoundation/CFData.h> 34#include <dispatch/dispatch.h> 35 36CF_EXTERN_C_BEGIN 37 38typedef struct __CFMessagePort * CFMessagePortRef; 39 40enum { 41 kCFMessagePortSuccess = 0, 42 kCFMessagePortSendTimeout = -1, 43 kCFMessagePortReceiveTimeout = -2, 44 kCFMessagePortIsInvalid = -3, 45 kCFMessagePortTransportError = -4, 46 kCFMessagePortBecameInvalidError = -5 47}; 48 49typedef struct { 50 CFIndex version; 51 void * info; 52 const void *(*retain)(const void *info); 53 void (*release)(const void *info); 54 CFStringRef (*copyDescription)(const void *info); 55} CFMessagePortContext; 56 57typedef CFDataRef (*CFMessagePortCallBack)(CFMessagePortRef local, SInt32 msgid, CFDataRef data, void *info); 58/* If callout wants to keep a hold of the data past the return of the callout, it must COPY the data. This includes the case where the data is given to some routine which _might_ keep a hold of it; System will release returned CFData. */ 59typedef void (*CFMessagePortInvalidationCallBack)(CFMessagePortRef ms, void *info); 60 61CF_EXPORT CFTypeID CFMessagePortGetTypeID(void); 62 63CF_EXPORT CFMessagePortRef CFMessagePortCreateLocal(CFAllocatorRef allocator, CFStringRef name, CFMessagePortCallBack callout, CFMessagePortContext *context, Boolean *shouldFreeInfo); 64CF_EXPORT CFMessagePortRef CFMessagePortCreateRemote(CFAllocatorRef allocator, CFStringRef name); 65 66CF_EXPORT Boolean CFMessagePortIsRemote(CFMessagePortRef ms); 67CF_EXPORT CFStringRef CFMessagePortGetName(CFMessagePortRef ms); 68CF_EXPORT Boolean CFMessagePortSetName(CFMessagePortRef ms, CFStringRef newName); 69CF_EXPORT void CFMessagePortGetContext(CFMessagePortRef ms, CFMessagePortContext *context); 70CF_EXPORT void CFMessagePortInvalidate(CFMessagePortRef ms); 71CF_EXPORT Boolean CFMessagePortIsValid(CFMessagePortRef ms); 72CF_EXPORT CFMessagePortInvalidationCallBack CFMessagePortGetInvalidationCallBack(CFMessagePortRef ms); 73CF_EXPORT void CFMessagePortSetInvalidationCallBack(CFMessagePortRef ms, CFMessagePortInvalidationCallBack callout); 74 75/* NULL replyMode argument means no return value expected, dont wait for it */ 76CF_EXPORT SInt32 CFMessagePortSendRequest(CFMessagePortRef remote, SInt32 msgid, CFDataRef data, CFTimeInterval sendTimeout, CFTimeInterval rcvTimeout, CFStringRef replyMode, CFDataRef *returnData); 77 78CF_EXPORT CFRunLoopSourceRef CFMessagePortCreateRunLoopSource(CFAllocatorRef allocator, CFMessagePortRef local, CFIndex order); 79 80CF_EXPORT void CFMessagePortSetDispatchQueue(CFMessagePortRef ms, dispatch_queue_t queue) CF_AVAILABLE(10_6, 4_0); 81 82CF_EXTERN_C_END 83 84#endif /* ! __COREFOUNDATION_CFMESSAGEPORT__ */ 85 86