IRandomAccessStreamReference interface

Applies to Windows and Windows Phone

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

Syntax


public interface class 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