IRandomAccessStreamReference Schnittstelle
Definition
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.
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 IRandomAccessStreamReferencePublic 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. |