CreateStreamOverRandomAccessStream 函式 (shcore.h)

  • 發行項

在 Windows 執行階段 IRandomAccessStream 物件周圍建立 IStream。

語法

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

參數

[in] randomAccessStream

來源 IRandomAccessStream。

[in] riid

要透過 ppv 擷取之介面 IID 的參考，通常IID_IStream。 此物件會封裝 randomAccessStream。

[out] ppv

當此方法成功傳回時，會包含 riid 中要求的介面指標，通常是 IStream。

傳回值

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

我們建議您使用 Objbase.h 中定義的 IID_PPV_ARGS 宏來封裝 riid 和 ppv 參數。 這個宏會根據 ppv 中值所指向的介面提供正確的 IID，這可消除 riid 中可能導致非預期結果的程式代碼錯誤的可能性。

規格需求

需求 值
最低支援的用戶端 Windows 8 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2012 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 shcore.h
程式庫 ShCore.lib
Dll ShCore.dll

另請參閱

CreateRandomAccessStreamOnFile

CreateRandomAccessStreamOverStream

RandomAccessStream