Partager via


IRandomAccessStreamReference Interface

Définition

Permet à un composant Windows Runtime de fournir l’accès à un flux encapsulé.

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
Dérivé
Attributs

Configuration requise pour Windows

Famille d’appareils
Windows 10 (introduit dans 10.0.10240.0)
API contract
Windows.Foundation.UniversalApiContract (introduit dans v1.0)

Remarques

Implémentez l’interface IRandomAccessStreamReference lorsque votre composant Windows Runtime expose un flux d’accès aléatoire aux appelants. Pour un flux séquentiel en lecture seule, implémentez l’interface IInputStreamReference .

Par exemple, un StorageFile fournit un IRandomAccessStream pour le contenu d’un fichier, de sorte qu’il implémente l’interface IRandomAccessStreamReference. En règle générale, la fourniture d’un flux nécessite l’accès au disque dur. Les opérations de flux sont donc asynchrones. Les composants qui utilisent le contenu du fichier reçoivent une référence IRandomAccessStreamReference au lieu d’une référence StorageFile , car cette interface est la configuration minimale requise pour le paramètre d’entrée.

Important

Toutes les sources ne peuvent pas fournir efficacement des flux d’accès aléatoire. Si un composant nécessite uniquement un accès en lecture séquentiel, envisagez d’implémenter l’interface IInputStreamReference au lieu de l’interface IRandomAccessStreamReference.

Méthodes

OpenReadAsync()

Ouvre un flux pour un accès aléatoire.

S’applique à

Voir aussi