다음을 통해 공유


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에서 도입되었습니다.)

설명

Windows 런타임 구성 요소가 호출자에게 임의 액세스 스트림을 노출하는 경우 IRandomAccessStreamReference 인터페이스를 구현합니다. 순차 읽기 전용 스트림의 경우 IInputStreamReference 인터페이스를 구현합니다.

예를 들어 StorageFile 은 파일 내용에 대한 IRandomAccessStream 을 제공하므로 IRandomAccessStreamReference 인터페이스를 구현합니다. 일반적으로 스트림을 제공하려면 하드 디스크에 액세스해야 하므로 스트림 작업은 비동기적입니다. 이 인터페이스는 입력 매개 변수에 대한 최소 요구 사항이므로 파일 콘텐츠를 사용하는 구성 요소는 StorageFile 참조 대신 IRandomAccessStreamReference를 받습니다.

중요

모든 원본이 임의 액세스 스트림을 효율적으로 제공할 수 있는 것은 아닙니다. 구성 요소에 순차적 읽기 액세스만 필요한 경우 IRandomAccessStreamReference 인터페이스 대신 IInputStreamReference 인터페이스를 구현하는 것이 좋습니다.

메서드

OpenReadAsync()

임의 액세스를 위한 스트림을 엽니다.

적용 대상

추가 정보