IStream 接口

 https://msdn.microsoft.com/en-us/library/windows/apps/aa380034

IStream接口允许您读取和写入 stream 对象的数据。流对象包含结构化的存储对象,存贮在哪里提供结构中的数据。简单的数据可以直接写入流,但最频繁,溪流是元素嵌套在一个存储对象。他们是类似于标准的文件。

IStream接口定义方法类似于的 MS-DOS 脂肪的文件功能。例如,每个流对象都有其自己的访问权限和查找指针。DOS 文件和流对象之间的主要区别是,在后者的情况下,流打开使用IStream接口指针,而不是一个文件句柄。

此接口中的方法呈现您的对象的数据作为一系列连续的你可以读取或写入的字节数。也有犯下和恢复是开放在事务处理的模式和方法来限制访问到某个范围的字节流中的流上更改方法。

溪流而无需占用文件系统资源的较长时间内可以保持打开状态。IUnknown::Release方法是类似于文件上的关闭功能。一旦释放,流对象将不再有效,不能使用。

客户端的异步名字对象可以选择之间数据推送或数据抽取的模型驱动异步IMoniker::BindToStorage操作和接收异步通知。更多的信息,请参阅URL 名字对象。下表比较行为的异步ISequentialStream::ReadIStream::Seek调用中这两个在IBindStatusCallback::OnDataAvailable返回下载模型︰

IStream 方法调用 数据拉入模型中的行为 数据推送模型中的行为
读取 Read 被调用来读取部分数据 (也就是说,并不是所有的可用数据) 返回 S_OK。客户端必须继续从IBindStatusCallback::OnDataAvailable返回之前读取所有可用的数据,否则绑定操作被阻止。(那就是,读取,直到返回 S_FALSE 或 E_PENDING) 返回 S_OK。即使客户端返回从IBindStatusCallback::OnDataAvailable在这一点上绑定操作继续和IBindStatusCallback::OnDataAvailable将再次调用多次,直到绑定完成。
读取 Read 被调用来读取所有可用的数据 如果尚未完成绑定操作,和更多的数据可用时,将再次调用IBindStatusCallback::OnDataAvailable将返回 E_PENDING。 数据拉入模型相同。
读取 Read 被调用来读取所有可用的数据和绑定操作已经结束 (结束的文件) 返回 S_FALSE。将grfBSC标记设置为 BSCF_LASTDATANOTIFICATION 到IBindStatusCallback::OnDataAvailable的后续调用。 数据拉入模型相同。
被称为Seek 寻求在数据拉模型无法正常工作 寻求并不适用于数据推模型。

有关此主题的一般信息,请参阅异步名字对象数据拉模型与数据推模型更具体的信息。请参阅管理内存分配有关 COM 的规则来管理内存的详细信息。

当执行

当您需要不提供 COM 复合文件实现功能时容器或对象应用程序上实现IStreamIStream该规范定义了更多的功能比 COM 执行支持。此外,如果您正在创建大于你的机器内存中堆的流对象和您正在使用的全局内存句柄,复合文件执行GlobalReAlloc在内部调用每当它需要更多的内存,可以是非常低效。在这种情况下,首选的解决方案是实现IStream使用由VirtualAlloc GlobalAlloc而分配的内存。这可以保留大量的虚拟地址空间,然后提交作为所需地址空间中的内存。没有数据复制发生和内存是承诺,它需要时才。更多的信息,请参阅IStream-复合文件执行

IStream接口从ISequentialStream继承了的方法。

注意大多数容器不实现ISequentialStream作为一个单独的接口,你并不需要分别提供它,即使您提供IStream执行。例如的复合文件实现的结构化存储为ISequentialStream不成功调用方法,但它包括通过IStream接口指针的的方法。
 

何时使用

从一个容器或应用程序来读取和写入对象的数据调用IStream接口的方法。因为流对象可以封送到其他进程,应用程序可以共享存储对象中的数据,而无需使用全局内存。

成员

IStream接口从IUnknown接口继承。IStream也有这些类型的成员︰

方法

IStream接口具有这些方法。

显示︰继承保护
方法 描述
克隆 Clone

创建一个新的流对象引用原来相同的字节流,但提供一个单独的寻求那些字节的指针。

提交 Commit

确保做一个 stream 对象在事务处理模式中打开的任何更改都反映在父存储对象。

CopyTo

复制指定的数目的字节从当前查找指针在当前流寻求另一个流中的指针。

LockRegion

限制到指定的流中的字节范围的访问。支持这项功能是可选的因为一些文件系统不提供它。

 Read

读取指定的数目的字节从流对象读入内存起价当前查找指针。

(从ISequentialStream的继承)

还原 Revert

放弃自上次调用IStream::Commit对事务处理流进行的所有更改。

寻求 Seek

将查找指针更改到新的位置相对于开始的流,流或当前查找指针的结尾。

SetSize

更改流对象的大小。

统计 Stat

检索此流的STATSTG结构。

UnlockRegion

移除以前限制与IStream::LockRegion的字节范围的访问限制。

 Write

写入指定的起价当前的流对象的字节数查找指针。

(从ISequentialStream的继承)

IStream 接口的更多相关文章

  1. go语言之接口二

    接口查询: 先来看如下的结构.结构体File实现了Read,Writer,Seek,Close的方法 type File struct{ } func (f *File) Read(buf []byt ...

  2. go语言之接口一

    在Go语言中,一个类只需要实现了接口要求的所有函数,我们就说这个类实现了该接口 我们定义了一个File类,并实现有Read().Write().Seek().Close()等方法.设 想我们有如下接口 ...

  3. BASE64编码和解码(VC源代码) 并 内存加载 CImage 图像

      BASE64可以用来将binary的字节序列数据编码成ASCII字符序列构成的文本.完整的BASE64定义可见 RFC1421和 RFC2045.编码后的数据比原始数据略长,为原来的4/3.在电子 ...

  4. 基于类型系统的面向对象编程语言Go

    (整理自网络) 面向对象编程 Go语言的面向对象编程(OOP)非常简洁而优雅.说它简洁,在于它没有了OOP中很多概念,比如:继承.虚函数.构造函数和析构函数.隐藏的this指针等等.说它优雅,是它的面 ...

  5. go语言入门

    Go语言最主要的特性: 自动垃圾回收 更丰富的内置类型 函数多返回值 错误处理 匿名函数和闭包 类型和接口 并发编程 反射 语言交互性 1.2.4 错误处理Go语言引入了3个关键字用 ...

  6. XMLHTTP使用具体解释

    XMLHTTP对象是Microsoft的MSXML开发包中带的一个用HTTP,XML协议訪问web资源的对象. 从MSXML3.0開始出现. 它在AJAX技术中主要用来从其它网络资源获取信息,然后由j ...

  7. IPicture总结

    1.利用IPicture接口加载.显示图片 IPicture接口管理一个图片对象和它的属性.图片对象提供对Bitmap Icon Metafile的语言不相关的抽象支持.图像对象的主要接口是IPict ...

  8. VC操作Image的三种方法(收集)

    忘记从哪来收集过来的资料了,暂且不管是哪位老兄写的,只道一声谢谢. 仅管VC有提供相应的API和类来操作bmp位图.图标和(增强)元文件,但却不支持jpg.gif和png等格式的图片,而这几种格式却是 ...

  9. 在VC下显示JPEG、GIF格式图像的一种简便方法

    在VC下显示JPEG.GIF格式图像的一种简便方法 一. 引言  JPEG图像压缩标准随然是一种有损图像压缩标准,但由于人眼视觉的不敏感,经压缩后的画质基本没有发生变化,很快便以较高的压缩率得到了广泛 ...

随机推荐

  1. Backbone源码解析(一):Event模块

    Backbone是一个当下比较流行的MVC框架.它主要分为以下几个模块: Events, View, Model, Collection, History, Router等几大模块.它强制依赖unde ...

  2. 【T-SQL基础】01.单表查询-几道sql查询题

    概述: 本系列[T-SQL基础]主要是针对T-SQL基础的总结. [T-SQL基础]01.单表查询-几道sql查询题 [T-SQL基础]02.联接查询 [T-SQL基础]03.子查询 [T-SQL基础 ...

  3. [.net 面向对象编程基础] (18) 泛型

    [.net 面向对象编程基础] (18) 泛型 上一节我们说到了两种数据类型数组和集合,数组是指包含同一类型的多个元素,集合是指.net中提供数据存储和检索的专用类. 数组使用前需要先指定大小,并且检 ...

  4. drag & resize元素的jQuery实现

    有时项目中会遇到需要拖动元素.拖拽调整元素大小的需求.大部分时候都不想自己写一遍,因为已经有很多现成的例子了.例如jqueryui提供的drag和resize.但是仅仅是为了这么小一个功能就引入一个库 ...

  5. js中各种跨域问题实战小结(一)

    什么是跨域?为什么要实现跨域呢? 这是因为JavaScript出于安全方面的考虑,不允许跨域调用其他页面的对象.也就是说只能访问同一个域中的资源.我觉得这就有必要了解下javascript中的同源策略 ...

  6. Linux常用命令(转)

    源自:http://www.linuxidc.com/Linux/2011-08/40437.htm Linux管理文件和目录的命令 命令 功能 命令 功能 pwd 显示当前目录 ls 查看目录下的内 ...

  7. IOS Runtime-初识runtime(一)

    苹果公布了runtime的源码,可以从地址下载:http://www.opensource.apple.com/tarballs/objc4/ object-c程序在启动的时候,需要一个准备时间,这个 ...

  8. iOS-数据持久化-第三方框架FMDB的使用

    FMDB简单介绍 一.简单说明 1.什么是FMDB FMDB是iOS平台的SQLite数据库框架 FMDB以OC的方式封装了SQLite的C语言API 2.FMDB的优点 使用起来更加面向对象,省去了 ...

  9. spring cvc-elt.1: Cannot find the declaration of element 'beans'解决办法

    转载自http://blog.csdn.net/legendj/article/details/9950963 今天在写spring aop示例的时候,在spring.xml文件中添加spring a ...

  10. CSS绝对定位的应用

    × 目录 [1]跟随图标 [2]视频提示 [3]下拉菜单[4]边缘对齐[5]星号 [6]全屏适应[7]半区翻图[8]九宫格[9]等高布局[10]整体布局 前面的话 之前的博客文章已经详细介绍过绝对定位 ...