Freigeben über


IRandomAccessStreamReference Schnittstelle

Definition

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
Attribute

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