Annotation of driverkit/Examples/loadable/Kernel/myDevice.h, revision 1.1.1.1

1.1       root        1: /*
                      2:  * Copyright (c) 1999 Apple Computer, Inc. All rights reserved.
                      3:  *
                      4:  * @APPLE_LICENSE_HEADER_START@
                      5:  * 
                      6:  * Portions Copyright (c) 1999 Apple Computer, Inc.  All Rights
                      7:  * Reserved.  This file contains Original Code and/or Modifications of
                      8:  * Original Code as defined in and that are subject to the Apple Public
                      9:  * Source License Version 1.1 (the "License").  You may not use this file
                     10:  * except in compliance with the License.  Please obtain a copy of the
                     11:  * License at http://www.apple.com/publicsource and read it before using
                     12:  * this file.
                     13:  * 
                     14:  * The Original Code and all software distributed under the License are
                     15:  * distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, EITHER
                     16:  * EXPRESS OR IMPLIED, AND APPLE HEREBY DISCLAIMS ALL SUCH WARRANTIES,
                     17:  * INCLUDING WITHOUT LIMITATION, ANY WARRANTIES OF MERCHANTABILITY,
                     18:  * FITNESS FOR A PARTICULAR PURPOSE OR NON- INFRINGEMENT.  Please see the
                     19:  * License for the specific language governing rights and limitations
                     20:  * under the License.
                     21:  * 
                     22:  * @APPLE_LICENSE_HEADER_END@
                     23:  */
                     24: /*     IOStub.h        1.0     01/29/91        (c) 1991 NeXT   
                     25:  *
                     26:  * myDevice.h - Interface for trivial I/O device subclass.
                     27:  *
                     28:  * HISTORY
                     29:  * 18-Dec-92    Doug Mitchell at NeXT
                     30:  *      Created. 
                     31:  */
                     32:  
                     33: #import <driverkit/return.h>
                     34: #import <driverkit/IODevice.h>
                     35: #import <kernserv/queue.h>
                     36: #import <machkit/NXLock.h>
                     37: 
                     38: /*
                     39:  * Operations performed by the I/O thread.
                     40:  */
                     41: typedef enum {
                     42:        OP_INIT,
                     43:        OP_SHUTDOWN
                     44: } myDeviceOp;
                     45: 
                     46: 
                     47: @interface myDevice : IODevice
                     48: {
                     49:        port_t          myDevicePort;
                     50:        
                     51:        /*
                     52:         * Commands are passed to the I/O thread via ioQueue, which is 
                     53:         * protected with qLock. 
                     54:         */
                     55:        queue_head_t    ioQueue;
                     56:        NXConditionLock *qLock;
                     57: }
                     58: 
                     59: /*
                     60:  * Public methods, called from myHandler.
                     61:  */
                     62: 
                     63: /*
                     64:  * Set device port.
                     65:  */
                     66: - (void)setDevicePort : (port_t)devicePort;
                     67: 
                     68: /*
                     69:  * Initialize.
                     70:  */
                     71: - init;
                     72: 
                     73: /*
                     74:  * Shut down, free resources.
                     75:  */
                     76: - (void)shutDown;
                     77: 
                     78: /*
                     79:  * Private methods.
                     80:  *
                     81:  * Send a cmdBuf to the I/O thread and wait for completion.
                     82:  */
                     83: - (IOReturn)enqueueCmd : (myDeviceOp)op;
                     84: 
                     85: /*
                     86:  * Initialize device, called from within the I/O thread.
                     87:  */
                     88: - (IOReturn)deviceInit;
                     89: 
                     90: @end

unix.superglobalmegacorp.com

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