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.
| Return code | Description |
|---|---|
|
The method succeeded. |
|
At least one of the required pointer arguments was NULL. |
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
| Requirement | Value |
|---|---|
| Target Platform | Windows |
| Header | portabledeviceapi.h |
| Library | PortableDeviceGUIDs.lib |