Annotation of XNU/iokit/IOKit/IOUserClient.h, revision 1.1.1.1

1.1       root        1: /*
                      2:  * Copyright (c) 1998-2000 Apple Computer, Inc. All rights reserved.
                      3:  *
                      4:  * @APPLE_LICENSE_HEADER_START@
                      5:  * 
                      6:  * The contents of this file constitute Original Code as defined in and
                      7:  * are subject to the Apple Public Source License Version 1.1 (the
                      8:  * "License").  You may not use this file except in compliance with the
                      9:  * License.  Please obtain a copy of the License at
                     10:  * http://www.apple.com/publicsource and read it before using this file.
                     11:  * 
                     12:  * This Original Code and all software distributed under the License are
                     13:  * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
                     14:  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
                     15:  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
                     16:  * FITNESS FOR A PARTICULAR PURPOSE OR NON-INFRINGEMENT.  Please see the
                     17:  * License for the specific language governing rights and limitations
                     18:  * under the License.
                     19:  * 
                     20:  * @APPLE_LICENSE_HEADER_END@
                     21:  */
                     22: 
                     23: /*
                     24:  * Changes to this API are expected.
                     25:  */
                     26: 
                     27: #ifndef _IOKIT_IOUSERCLIENT_H
                     28: #define _IOKIT_IOUSERCLIENT_H
                     29: 
                     30: #include <IOKit/IOTypes.h>
                     31: #include <IOKit/IOService.h>
                     32: #include <IOKit/OSMessageNotification.h>
                     33: 
                     34: 
                     35: enum {
                     36:     kIOUCTypeMask      = 0x0000000f,
                     37:     kIOUCScalarIScalarO = 0,
                     38:     kIOUCScalarIStructO = 2,
                     39:     kIOUCStructIStructO = 3,
                     40:     kIOUCScalarIStructI = 4,
                     41: };
                     42: 
                     43: typedef IOReturn (IOService::*IOMethod)(void * p1, void * p2, void * p3,
                     44:                                         void * p4, void * p5, void * p6 );
                     45: 
                     46: typedef IOReturn (IOService::*IOAsyncMethod)(OSAsyncReference asyncRef,
                     47:                                         void * p1, void * p2, void * p3,
                     48:                                         void * p4, void * p5, void * p6 );
                     49: 
                     50: struct IOExternalMethod {
                     51:     IOService *                object;
                     52:     IOMethod           func;
                     53:     IOOptionBits       flags;
                     54:     IOByteCount                count0;
                     55:     IOByteCount                count1;
                     56: };
                     57: 
                     58: struct IOExternalAsyncMethod {
                     59:     IOService *                object;
                     60:     IOAsyncMethod      func;
                     61:     IOOptionBits       flags;
                     62:     IOByteCount                count0;
                     63:     IOByteCount                count1;
                     64: };
                     65: 
                     66: enum {
                     67:     kIOUserNotifyMaxMessageSize = 64
                     68: };
                     69: 
                     70: class IOUserClient : public IOService
                     71: {
                     72:     OSDeclareAbstractStructors(IOUserClient)
                     73: 
                     74: protected:
                     75:     static IOReturn sendAsyncResult(OSAsyncReference reference,
                     76:                                     IOReturn result, void *args[], UInt32 numArgs);
                     77: 
                     78: public:
                     79: 
                     80:     static void initialize( void );
                     81: 
                     82:     static void destroyUserReferences( OSObject * obj );
                     83: 
                     84:     virtual IOReturn clientClose( void );
                     85:     virtual IOReturn clientDied( void );
                     86: 
                     87:     virtual IOService * getService( void );
                     88: 
                     89:     virtual IOReturn registerNotificationPort(
                     90:                mach_port_t port, UInt32 type, UInt32 refCon );
                     91: 
                     92:     virtual IOReturn getNotificationSemaphore( UInt32 notification_type,
                     93:                                     semaphore_t * semaphore );
                     94: 
                     95:     virtual IOReturn connectClient( IOUserClient * client );
                     96: 
                     97:     // memory will be released by user client when last map is destroyed
                     98:     virtual IOReturn clientMemoryForType( UInt32 type,
                     99:                                IOOptionBits * options,
                    100:                                IOMemoryDescriptor ** memory );
                    101: 
                    102:     virtual IOMemoryMap * mapClientMemory( IOOptionBits type,
                    103:                                     task_t task,
                    104:                                     IOOptionBits mapFlags = kIOMapAnywhere,
                    105:                                    IOVirtualAddress atAddress = 0 );
                    106: 
                    107:     virtual IOExternalMethod * getExternalMethodForIndex( UInt32 index );
                    108:     virtual IOExternalAsyncMethod * getExternalAsyncMethodForIndex( UInt32 index );
                    109: 
                    110: };
                    111: 
                    112: #endif /* ! _IOKIT_IOUSERCLIENT_H */
                    113: 

unix.superglobalmegacorp.com

This archive runs on limited infrastructure. Preserving old code on modern bandwidth. Automated agents are requested to crawl responsibly.