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 IRandomAccessStreamReferencePublic 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() |
Открывает поток для произвольного доступа. |