Return to myDevice.h CVS log

Up to [Apple Darwin 0.x] / driverkit / Examples / loadable / Kernel

Annotation of driverkit/Examples/loadable/Kernel/myDevice.h, revision 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

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