Objective Systems, Inc.  
Home
About ASN.1
Products
Free Software
Documents
Services
Resources
Resellers
Customers
Careers
About Us
Contact Us
 

Google


Objective Systems, Inc.

rtxStreamDirectBuf.h

Go to the documentation of this file.
00001 /*
00002  * Copyright (c) 2003-2006 Objective Systems, Inc.
00003  *
00004  * This software is furnished under a license and may be used and copied
00005  * only in accordance with the terms of such license and with the
00006  * inclusion of the above copyright notice. This software or any other
00007  * copies thereof may not be provided or otherwise made available to any
00008  * other person. No title to and ownership of the software is hereby
00009  * transferred.
00010  *
00011  * The information in this software is subject to change without notice
00012  * and should not be construed as a commitment by Objective Systems, Inc.
00013  *
00014  * PROPRIETARY NOTICE
00015  *
00016  * This software is an unpublished work subject to a confidentiality agreement
00017  * and is protected by copyright and trade secret law.  Unauthorized copying,
00018  * redistribution or other use of this work is prohibited.
00019  *
00020  * The above notice of copyright on this source code product does not indicate
00021  * any actual or intended publication of such source code.
00022  *
00023  *****************************************************************************/
00027 #ifndef _RTXSTREAMDIRECTBUF_H_
00028 #define _RTXSTREAMDIRECTBUF_H_
00029 
00030 
00031 #include "rtxsrc/rtxCommon.h"
00032 #include "rtxsrc/rtxStream.h"
00033 
00034 #ifdef __cplusplus
00035 extern "C" {
00036 #endif
00037 
00038 /*
00039  * This function initializes a buffered stream. This function should be called
00040  * first before any operation with a buffered stream.
00041  *
00042  * @param pctxt        Pointer to context structure variable.
00043  * @return             Completion status of operation: 0 (0) = success,
00044  *                       negative return value is error.
00045  */
00046 EXTERNRTX int rtxStreamDirectBufCreate (OSCTXT* pctxt);
00047 
00048 /*
00049  * This function pre-reads a 'size' number of octets of data from the input
00050  * stream into the internal stream buffer. This functions blocks until all
00051  * necessary data is read, end of file is detected, or another error 
00052  * occurs. This function guarantees that the internal buffer will contain at
00053  * least the 'size' number of octets. Thus, it is possible to obtain direct
00054  * access to the memory buffer with pre-read data by using the 'buffer' field
00055  * of the OSCTXT context block.
00056  *
00057  * @param pctxt        Pointer to a context structure variable that has 
00058  *                       been initialized for stream operations.
00059  * @param size         Number of octets to be pre-read.
00060  * @return             Completion status of operation: 0 (0) = success,
00061  *                       negative return value is error.
00062  */
00063 EXTERNRTX int rtxStreamDirectBufPreRead (OSCTXT* pctxt, size_t size);
00064 
00065 #ifdef __cplusplus
00066 }
00067 #endif
00068 
00069 #endif /* _RTXSTREAMDIRECTBUF_H_ */
00070 

This file was last modified on 8 Jan 2007.
XBinder, Version 1.1.9