Поделиться через


IRandomAccessStreamReference Интерфейс

Определение

Позволяет компоненту среда выполнения 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
Производный
Атрибуты

Требования к Windows

Семейство устройств
Windows 10 (появилось в 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (появилось в v1.0)

Комментарии

Реализуйте интерфейс IRandomAccessStreamReference, когда компонент среда выполнения Windows предоставляет вызывающим абонентам поток произвольного доступа. Для последовательного потока, доступного только для чтения, реализуйте интерфейс IInputStreamReference .

Например, StorageFile предоставляет IRandomAccessStream для содержимого файла, поэтому он реализует интерфейс IRandomAccessStreamReference. Обычно для предоставления потока требуется доступ к жесткому диску, поэтому потоковые операции являются асинхронными. Компоненты, использующие содержимое файла, получают IRandomAccessStreamReference вместо ссылки StorageFile , так как этот интерфейс является более минимальным требованием для входного параметра.

Важно!

Не все источники могут эффективно предоставлять потоки произвольного доступа. Если компоненту требуется только последовательный доступ на чтение, рассмотрите возможность реализации интерфейса IInputStreamReference вместо интерфейса IRandomAccessStreamReference.

Методы

OpenReadAsync()

Открывает поток для произвольного доступа.

Применяется к

См. также раздел