IStream 接口

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

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

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

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

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

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

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

当执行

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

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

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

何时使用

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

成员

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

• 方法

方法

IStream接口具有这些方法。

显示︰继承保护