IRandomAccessStreamReference interface

Enables a Windows Runtime component to provide access to an encapsulated stream.

Syntax

public interface IRandomAccessStreamReference

Attributes

GuidAttribute("33ee3134-1dd6-4e3a-8067-d1c162e8642b")

VersionAttribute(NTDDI_WIN8)

Members

The IRandomAccessStreamReference interface has these types of members:

• Methods

Methods

The IRandomAccessStreamReference interface has these methods. It also inherits methods from the Object class.

Remarks

Implement the IRandomAccessStreamReference interface when your Windows Runtime component exposes a random access stream to callers. For a sequential read-only stream, implement the IInputStreamReference interface.

For example, a StorageFile provides an IRandomAccessStream for the contents of a file, so it implements the IRandomAccessStreamReference interface. Usually, providing a stream requires accessing the hard disk, so stream operations are asynchronous. Components that consume file content receive an IRandomAccessStreamReference instead of a StorageFile reference, because this interface is the more minimal requirement for the input parameter.

Important  Not all sources can provide random access streams efficiently. If a component requires only sequential read access, consider implementing the IInputStreamReference interface instead of the IRandomAccessStreamReference interface.

Requirements

See also

IInputStreamReference

Build date: 2/25/2013