IStream - 复合文件实现

项目
06/13/2023

IStream 接口支持将数据读取和写入流对象。在结构化存储对象中，流对象包含数据，存储提供结构。简单数据可以直接写入流，但更常见的是，流是嵌套在存储对象中的元素。它们类似于标准文件。

IStream 的规范定义了比 COM 实现支持的更多功能。例如， IStream 接口定义长达 2⁶⁴ 字节的流，需要 64 位查找指针。但是，COM 实现仅支持长度为 22² 字节的流 (4 GB) 并且读取和写入操作一次始终限制为 22² 字节。 COM 实现也不支持流事务处理或区域锁定。

若要基于全局内存创建简单流，请通过调用 API 函数 CreateStreamOnHGlobal 获取 IStream 指针。若要在复合文件对象中获取 IStream 指针，请调用 StgCreateDocfile 或 StgOpenStorage。这些函数检索 IStorage 指针，然后使用该指针为 IStream 指针调用 CreateStream 或 OpenStream。在任一情况下，都使用相同的 IStream 实现代码。

注意

结构化存储的复合文件实现在适用于 ISequentialStream 的 QueryInterface 方法上不成功，但它通过 IStream 接口指针包含读取和写入方法。

何时使用

调用 IStream 的方法以将数据读取和写入流。

由于流对象可以封送给其他进程，因此应用程序可以在存储对象中共享数据，而无需使用全局内存。在流对象的 COM 复合文件实现中，当两个进程具有共享内存访问时，COM 中的自定义封送处理设施在新进程中创建原始对象的远程版本。因此，远程版本不需要与原始进程通信来执行其功能。

流对象的远程版本与原始流共享相同的搜寻指针。如果不想共享 seek 指针，请使用 IStream：：Clone 方法为远程进程提供流对象的副本。

注意

如果创建大于计算机内存中堆的流对象，并且对全局内存对象使用 HGLOBAL 句柄，则流对象在内部调用 GlobalRealloc 方法，而它需要更多的内存。由于 GlobalRealloc 始终将数据从源复制到目标，因此例如，将流对象从 20 MB 增加到 25 MB 需要大量的时间。这是由于复制的增量大小造成的，如果由于磁盘交换，计算机上内存少于 45 MB，则情况会恶化。

首选解决方案是实现使用 VirtualAlloc 而不是 GlobalAlloc 分配的内存的 IStream 方法。这可以保留一大块虚拟地址空间，然后根据需要在该地址空间内提交内存。不会进行数据复制，并且仅在需要时提交内存。

GlobalRealloc 的替代方法是在流对象上调用 IStream：：SetSize 方法，以提前增加内存分配。但是，这并不像使用 VirtualAlloc 那样高效，如上文所述。