Edit

IWICStream::InitializeFromIStreamRegion method (wincodec.h)

  • Article

Initializes the stream as a substream of another stream.

Syntax

HRESULT InitializeFromIStreamRegion(
  [in] IStream        *pIStream,
  [in] ULARGE_INTEGER ulOffset,
  [in] ULARGE_INTEGER ulMaxSize
);

Parameters

[in] pIStream

Type: IStream*

Pointer to the input stream.

[in] ulOffset

Type: ULARGE_INTEGER

The stream offset used to create the new stream.

[in] ulMaxSize

Type: ULARGE_INTEGER

The maximum size of the stream.

Return value

Type: HRESULT

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

Remarks

The stream functions with its own stream position, independent of the underlying stream but restricted to a region. All seek positions are relative to the sub region. It is allowed, though not recommended, to have multiple writable sub streams overlapping the same range.

Requirements

Requirement Value
Minimum supported client Windows XP with SP2, Windows Vista [desktop apps | UWP apps]
Minimum supported server Windows Server 2008 [desktop apps | UWP apps]
Target Platform Windows
Header wincodec.h
Library Windowscodecs.lib
DLL Windowscodecs.dll