CreateRandomAccessStreamOverStream, fonction (shcore.h)

Crée un flux d’accès aléatoire Windows Runtime autour d’une implémentation de base IStream.

Syntaxe

HRESULT CreateRandomAccessStreamOverStream(
  [in]  IStream      *stream,
  [in]  BSOS_OPTIONS options,
  [in]  REFIID       riid,
  [out] void         **ppv
);

Paramètres

[in] stream

Flux COM à encapsuler.

[in] options

L’une des options BSOS_OPTIONS qui spécifient le comportement de RandomAccessStream qui encapsule le flux.

[in] riid

Référence à l’IID de l’interface à récupérer via ppv, généralement IID_RandomAccessStream.

[out] ppv

Lorsque cette méthode retourne correctement, contient le pointeur d’interface vers randomAccessStream qui encapsule le flux demandé dans riid.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Remarques

Utilisez la fonction CreateRandomAccessStreamOverStream pour créer un RandomAccessStream qui encapsule un IStream COM.

Pour plus d’informations sur les classes utilitaires qui facilitent l’interopérabilité entre les flux Windows Runtime et COM, consultez les remarques sur RandomAccessStreamOverStream.

Nous vous recommandons d’utiliser la macro IID_PPV_ARGS , définie dans Objbase.h, pour empaqueter les paramètres riid et ppv . Cette macro fournit l’IID correct en fonction de l’interface pointée par la valeur dans ppv, ce qui élimine la possibilité d’une erreur de codage dans riid qui pourrait entraîner des résultats inattendus.

Configuration requise

Voir aussi

CreateRandomAccessStreamOnFile

CreateStreamOverRandomAccessStream

RandomAccessStream