Edit

IWICStream::InitializeFromMemory method (wincodec.h)

  • Article

Initializes a stream to treat a block of memory as a stream. The stream cannot grow beyond the buffer size.

Syntax

HRESULT InitializeFromMemory(
  [in] WICInProcPointer pbBuffer,
  [in] DWORD            cbBufferSize
);

Parameters

[in] pbBuffer

Type: BYTE*

Pointer to the buffer used to initialize the stream.

[in] cbBufferSize

Type: DWORD

The size of buffer.

Return value

Type: HRESULT

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

Remarks

This method should be avoided whenever possible. The caller is responsible for ensuring the memory block is valid for the lifetime of the stream when using InitializeFromMemory. A workaround for this behavior is to create an IStream and use InitializeFromIStream to create the IWICStream.

If you require a growable memory stream, use CreateStreamOnHGlobal.

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