CreateRandomAccessStreamOverStream 関数 (shcore.h)
IStream 基本実装を中心にWindows ランタイムランダム アクセス ストリームを作成します。
構文
HRESULT CreateRandomAccessStreamOverStream(
[in] IStream *stream,
[in] BSOS_OPTIONS options,
[in] REFIID riid,
[out] void **ppv
);
パラメーター
[in] stream
カプセル化する COM ストリーム。
[in] options
ストリームをカプセル化する RandomAccessStream の動作を指定するBSOS_OPTIONS オプションの 1 つ。
[in] riid
ppv を介して取得するインターフェイスの IID への参照 。通常はIID_RandomAccessStream。
[out] ppv
このメソッドが正常に返されると、 には、riid で要求されたストリームをカプセル化する RandomAccessStream へのインターフェイス ポインターが含まれます。
戻り値
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
注釈
CREATERandomAccessStreamOverStream 関数を使用して、COM IStream をカプセル化する RandomAccessStream を作成します。
Windows ランタイム ストリームと COM ストリーム間の相互運用に役立つユーティリティ クラスについては、「RandomAccessStreamOverStream の解説」を参照してください。
riid パラメーターと ppv パラメーターをパッケージ化するには、Objbase.h で定義されている IID_PPV_ARGS マクロを使用することをお勧めします。 このマクロは 、ppv の値によって指されるインターフェイスに基づいて正しい IID を提供します。これにより、 riid でコーディング エラーが発生し、予期しない結果が発生する可能性がなくなります。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows 8 [デスクトップ アプリ |UWP アプリ] |
サポートされている最小のサーバー | Windows Server 2012 [デスクトップ アプリ |UWP アプリ] |
対象プラットフォーム | Windows |
ヘッダー | shcore.h |
Library | ShCore.lib |
[DLL] | ShCore.dll |
こちらもご覧ください
CreateRandomAccessStreamOnFile