Information
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IRandomAccessStreamReference interface

Applies to Windows and Windows Phone

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

Syntax


public interface IRandomAccessStreamReference

Attributes

[Version(0x06020000)]

Members

The IRandomAccessStreamReference interface has these types of members:

Methods

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

MethodDescription
OpenReadAsync Opens a stream for random access.

 

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

Minimum supported client

Windows 8

Minimum supported server

Windows Server 2012

Minimum supported phone

Windows Phone 8

Namespace

Windows.Storage.Streams
Windows::Storage::Streams [C++]

Metadata

Windows.winmd

See also

IInputStreamReference

 

 

Show:
© 2014 Microsoft