共用方式為

IPortableDeviceResources：：GetStream 方法 (portabledeviceapi.h)

  • 發行項

GetStream 方法會取得 IStream 介面，用來讀取或寫入裝置上對象中的內容數據。 擷取的介面可讓您讀取或寫入對象數據。

語法

HRESULT GetStream(
  [in]      LPCWSTR        pszObjectID,
  [in]      REFPROPERTYKEY Key,
  [in]      const DWORD    dwMode,
  [in, out] DWORD          *pdwOptimalBufferSize,
  [out]     IStream        **ppStream
);

參數

[in] pszObjectID

包含物件識別碼之 Null 終止字串的指標。

[in] Key

REFPROPERTYKEY，指定要讀取的資源。 您可以呼叫 GetSupportedResources 來擷取所有物件資源的索引鍵。

[in] dwMode

下列其中一種存取模式：

  • STGM_READ (只读 access.)
  • STGM_WRITE (只读存取。)
  • STGM_READWRITE (可擦写的 access.)

[in, out] pdwOptimalBufferSize

DWORD 的選擇性指標，指定使用 ppStream 讀取或寫入數據時要使用的最佳緩衝區大小估計值。 需要驅動程式才能支援此值。

[out] ppStream

IStream 介面指標的指標。 這個介面是用來讀取和寫入對象的數據。 呼叫端必須在使用此介面完成時釋放這個介面。

傳回值

方法會傳回 HRESULT。 可能的值包括 (但不限於) 下表中的這些值。

傳回碼 描述
S_OK
 此方法已成功。
E_POINTER
 至少其中一個必要的指標自變數為 NULL。

備註

擷取的數據流無法以遞歸方式讀取資料夾的內容。 若要複製物件中的所有資源，請為 Key 指定WPD_RESOURCE_DEFAULT。

如果物件不支援資源，這個方法會傳回錯誤， 而 ppStream 會是 NULL。

當配置緩衝區進行讀取或寫入作業時，應用程式應該使用 pdwOptimalBufferSize 所傳回的緩衝區大小。

規格需求

需求 值
目標平台 Windows
標頭 portabledeviceapi.h
程式庫 PortableDeviceGUIDs.lib

另請參閱

IPortableDeviceResources 介面