Compartilhar via


Função CreateStreamOverRandomAccessStream (shcore.h)

Cria um IStream em torno de um objeto IRandomAccessStream Windows Runtime.

Sintaxe

HRESULT CreateStreamOverRandomAccessStream(
  [in]  IUnknown *randomAccessStream,
  [in]  REFIID   riid,
  [out] void     **ppv
);

Parâmetros

[in] randomAccessStream

O IRandomAccessStream de origem.

[in] riid

Uma referência ao IID da interface a ser recuperada por meio de ppv, normalmente IID_IStream. Esse objeto encapsula randomAccessStream.

[out] ppv

Quando esse método retorna com êxito, contém o ponteiro de interface solicitado em riid, normalmente IStream.

Retornar valor

Se essa função for bem-sucedida, ela retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Recomendamos que você use a macro IID_PPV_ARGS , definida em Objbase.h, para empacotar os parâmetros riid e ppv . Essa macro fornece o IID correto com base na interface apontada pelo valor em ppv, o que elimina a possibilidade de um erro de codificação no riid que pode levar a resultados inesperados.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8 [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo com suporte Windows Server 2012 [aplicativos da área de trabalho | Aplicativos UWP]
Plataforma de Destino Windows
Cabeçalho shcore.h
Biblioteca ShCore.lib
DLL ShCore.dll

Confira também

CreateRandomAccessStreamOnFile

CreateRandomAccessStreamOverStream

RandomAccessStream