IPortableDeviceResources::GetStream method (portabledeviceapi.h)

The GetStream method gets an IStream interface with which to read or write the content data in an object on a device. The retrieved interface enables you to read from or write to the object data.

Syntax

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

Parameters

[in] pszObjectID

Pointer to a null-terminated string that contains the object ID of the object.

[in] Key

A REFPROPERTYKEY that specifies which resource to read. You can retrieve the keys of all the object's resources by calling GetSupportedResources.

[in] dwMode

One of the following access modes:

• STGM_READ (Read-only access.)
• STGM_WRITE (Write-only access.)
• STGM_READWRITE (Read/write access.)

[in, out] pdwOptimalBufferSize

An optional pointer to a DWORD that specifies an estimate of the best buffer size to use when reading or writing data by using ppStream. A driver is required to support this value.

[out] ppStream

Pointer to an IStream interface pointer. This interface is used to read and write data to the object. The caller must release this interface when it is done with it.

Return value

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Remarks

The retrieved stream cannot read the contents of a folder recursively. To copy all the resources in an object, specify WPD_RESOURCE_DEFAULT for Key.

If the object does not support resources, this method will return an error, and ppStream will be NULL.

Applications should use the buffer size returned by pdwOptimalBufferSize when allocating the buffer for read or write operations.

Requirements

See also

IPortableDeviceResources Interface