IWICStream::InitializeFromMemory method (wincodec.h)

Article
02/22/2024

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

Share via