IRandomAccessStreamReference インターフェイス

  • リファレンス

定義

名前空間:
Windows.Storage.Streams
編集

Windows ランタイム コンポーネントがカプセル化されたストリームへのアクセスを提供できるようにします。

public interface class IRandomAccessStreamReference
/// [Windows.Foundation.Metadata.ContractVersion(Windows.Foundation.UniversalApiContract, 65536)]
/// [Windows.Foundation.Metadata.Guid(871248180, 7638, 20026, 128, 103, 209, 193, 98, 232, 100, 43)]
struct IRandomAccessStreamReference
[Windows.Foundation.Metadata.ContractVersion(typeof(Windows.Foundation.UniversalApiContract), 65536)]
[Windows.Foundation.Metadata.Guid(871248180, 7638, 20026, 128, 103, 209, 193, 98, 232, 100, 43)]
public interface IRandomAccessStreamReference
Public Interface IRandomAccessStreamReference
派生
属性
ContractVersionAttribute GuidAttribute

Windows の要件

デバイス ファミリ
Windows 10 (10.0.10240.0 で導入)
API contract
Windows.Foundation.UniversalApiContract (v1.0 で導入)

注釈

Windows ランタイム コンポーネントがランダム アクセス ストリームを呼び出し元に公開するときに、IRandomAccessStreamReference インターフェイスを実装します。 シーケンシャル読み取り専用ストリームの場合は、 IInputStreamReference インターフェイスを実装します。

たとえば、 StorageFile は ファイルの内容に IRandomAccessStream を提供するため、IRandomAccessStreamReference インターフェイスを実装します。 通常、ストリームを提供するにはハード ディスクにアクセスする必要があるため、ストリーム操作は非同期です。 このインターフェイスは入力パラメーターの最小要件であるため、ファイル コンテンツを使用するコンポーネントは StorageFile 参照ではなく IRandomAccessStreamReference を受け取ります。

重要

すべてのソースがランダム アクセス ストリームを効率的に提供できるわけではありません。 コンポーネントでシーケンシャル読み取りアクセスのみが必要な場合 は、IRandomAccessStreamReference インターフェイスではなく IInputStreamReference インターフェイスを実装することを検討してください。

メソッド

OpenReadAsync()

ランダム アクセス用のストリームを開きます。

適用対象

こちらもご覧ください