IRandomAccessStreamReference 인터페이스
정의
중요
일부 정보는 릴리스되기 전에 상당 부분 수정될 수 있는 시험판 제품과 관련이 있습니다. Microsoft는 여기에 제공된 정보에 대해 어떠한 명시적이거나 묵시적인 보증도 하지 않습니다.
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에서 도입되었습니다.)
|
설명
Windows 런타임 구성 요소가 호출자에게 임의 액세스 스트림을 노출하는 경우 IRandomAccessStreamReference 인터페이스를 구현합니다. 순차 읽기 전용 스트림의 경우 IInputStreamReference 인터페이스를 구현합니다.
예를 들어 StorageFile 은 파일 내용에 대한 IRandomAccessStream 을 제공하므로 IRandomAccessStreamReference 인터페이스를 구현합니다. 일반적으로 스트림을 제공하려면 하드 디스크에 액세스해야 하므로 스트림 작업은 비동기적입니다. 이 인터페이스는 입력 매개 변수에 대한 최소 요구 사항이므로 파일 콘텐츠를 사용하는 구성 요소는 StorageFile 참조 대신 IRandomAccessStreamReference를 받습니다.
중요
모든 원본이 임의 액세스 스트림을 효율적으로 제공할 수 있는 것은 아닙니다. 구성 요소에 순차적 읽기 액세스만 필요한 경우 IRandomAccessStreamReference 인터페이스 대신 IInputStreamReference 인터페이스를 구현하는 것이 좋습니다.
메서드
| OpenReadAsync() |
임의 액세스를 위한 스트림을 엽니다. |