IRandomAccessStreamReference Interface
Definição
Importante
Algumas informações se referem a produtos de pré-lançamento que podem ser substancialmente modificados antes do lançamento. A Microsoft não oferece garantias, expressas ou implícitas, das informações aqui fornecidas.
Permite que um componente Windows Runtime forneça acesso a um fluxo encapsulado.
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- Derivado
- Atributos
Requisitos do Windows
| Família de dispositivos |
Windows 10 (introduzida na 10.0.10240.0)
|
| API contract |
Windows.Foundation.UniversalApiContract (introduzida na v1.0)
|
Comentários
Implemente a interface IRandomAccessStreamReference quando o componente Windows Runtime expõe um fluxo de acesso aleatório aos chamadores. Para um fluxo somente leitura sequencial, implemente a interface IInputStreamReference .
Por exemplo, um StorageFile fornece um IRandomAccessStream para o conteúdo de um arquivo, de modo que ele implementa a interface IRandomAccessStreamReference. Normalmente, fornecer um fluxo requer o acesso ao disco rígido, portanto, as operações de fluxo são assíncronas. Os componentes que consomem conteúdo do arquivo recebem um IRandomAccessStreamReference em vez de uma referência storageFile , pois essa interface é o requisito mais mínimo para o parâmetro de entrada.
Importante
Nem todas as fontes podem fornecer fluxos de acesso aleatórios com eficiência. Se um componente exigir apenas acesso de leitura sequencial, considere implementar a interface IInputStreamReference em vez da interface IRandomAccessStreamReference.
Métodos
| OpenReadAsync() |
Abre um fluxo para acesso aleatório. |