Функция CreateRandomAccessStreamOverStream (shcore.h)
Создает поток среда выполнения Windows произвольного доступа вокруг базовой реализации IStream.
Синтаксис
HRESULT CreateRandomAccessStreamOverStream(
[in] IStream *stream,
[in] BSOS_OPTIONS options,
[in] REFIID riid,
[out] void **ppv
);
Параметры
[in] stream
Инкапсулируемый COM-поток.
[in] options
Один из BSOS_OPTIONS параметров, определяющих поведение RandomAccessStream , инкапсулирующего поток.
[in] riid
Ссылка на IID интерфейса, извлекаемого через ppv, обычно IID_RandomAccessStream.
[out] ppv
При успешном возвращении этого метода содержит указатель интерфейса на RandomAccessStream , который инкапсулирует поток , запрошенный в riid.
Возвращаемое значение
Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .
Комментарии
Используйте функцию CreateRandomAccessStreamOverStream , чтобы создать RandomAccessStream , инкапсулирующий COM IStream.
Сведения о служебных классах, которые помогают в взаимодействии между потоками среда выполнения Windows и COM, см. в разделе Примечания в RandomAccessStreamOverStream.
Мы рекомендуем использовать макрос IID_PPV_ARGS , определенный в Objbase.h, для упаковки параметров riid и ppv . Этот макрос предоставляет правильный КОД на основе интерфейса, на который указывает значение в ppv, что исключает возможность ошибки кодирования в riid , которая может привести к непредвиденным результатам.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2012 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | shcore.h |
| Библиотека | ShCore.lib |
| DLL | ShCore.dll |
См. также раздел
CreateRandomAccessStreamOnFile