IRandomAccessStreamReference Schnittstelle

Referenz

Definition

Namespace:: Windows.Storage.Streams

Wichtig

Einige Informationen beziehen sich auf Vorabversionen, die vor dem Release ggf. grundlegend überarbeitet werden. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

Bearbeiten

Ermöglicht einer Windows-Runtime Komponente den Zugriff auf einen gekapselten Datenstrom.

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

Abgeleitet: Windows.Services.TargetedContent.TargetedContentFile

Windows.Services.TargetedContent.TargetedContentImage

Windows.Storage.BulkAccess.FileInformation

Windows.Storage.IStorageFile

Windows.Storage.StorageFile

Mehr …

Attribute: ContractVersionAttribute GuidAttribute

Windows-Anforderungen

Gerätefamilie	Windows 10 (eingeführt in 10.0.10240.0)
API contract	Windows.Foundation.UniversalApiContract (eingeführt in v1.0)

Hinweise

Implementieren Sie die IRandomAccessStreamReference-Schnittstelle, wenn Ihre Windows-Runtime-Komponente einen Zufälligen Zugriffsdatenstrom für Aufrufer verfügbar macht. Implementieren Sie für einen sequenziellen schreibgeschützten Stream die IInputStreamReference-Schnittstelle .

Beispielsweise stellt eine StorageFile einen IRandomAccessStream für den Inhalt einer Datei bereit, sodass die IRandomAccessStreamReference-Schnittstelle implementiert wird. Normalerweise erfordert die Bereitstellung eines Datenstroms den Zugriff auf die Festplatte, sodass Streamvorgänge asynchron sind. Komponenten, die Dateiinhalte nutzen, erhalten einen IRandomAccessStreamReference anstelle eines StorageFile-Verweises , da diese Schnittstelle die minimale Anforderung für den Eingabeparameter ist.

Wichtig

Nicht alle Quellen können Datenströme mit zufälligem Zugriff effizient bereitstellen. Wenn für eine Komponente nur sequenzieller Lesezugriff erforderlich ist, sollten Sie die IInputStreamReference-Schnittstelle anstelle der IRandomAccessStreamReference-Schnittstelle implementieren.

Methoden

OpenReadAsync()

Öffnet einen Stream für den zufälligen Zugriff.

Gilt für:

Weitere Informationen

IInputStreamReference