interface ICoreWebView2ExperimentalSharedBuffer

Note

This reference is no longer being maintained. For the latest API reference, see WebView2 API Reference.

Note

This an experimental API that is shipped with our prerelease SDK. See WebView2 release notes.

interface ICoreWebView2ExperimentalSharedBuffer
  : public IUnknown

The shared buffer object.

Summary

Members Descriptions
Close Release the backing shared memory.
get_Buffer The memory address of the shared buffer.
get_FileMappingHandle Returns a handle to the file mapping object that backs this shared buffer.
get_Size The size of the shared buffer in bytes.
OpenStream Get an IStream object that can be used to access the shared buffer.

Applies to

Product Introduced
WebView2 Win32 N/A
WebView2 Win32 Prerelease

Members

Close

Release the backing shared memory.

public HRESULT Close()

The application should call this API when no access to the buffer is needed any more, to ensure that the underlying resources are released timely even if the shared buffer object itself is not released due to some leaked reference. After the shared buffer is closed, the buffer address and file mapping handle previously obtained becomes invalid and cannot be used anymore. Accessing properties of the object will fail with RO_E_CLOSED. Operations like Read or Write on the IStream objects returned from OpenStream will fail with RO_E_CLOSED. PostSharedBufferToScript will also fail with RO_E_CLOSED.

The script code should call chrome.webview.releaseBuffer with the shared buffer as the parameter to release underlying resources as soon as it does not need access the shared buffer any more. When script tries to access the buffer after calling chrome.webview.releaseBuffer, JavaScript TypeError exception will be raised complaining about accessing a detached ArrayBuffer, the same exception when trying to access a transferred ArrayBuffer.

Closing the buffer object on native side doesn't impact access from Script and releasing the buffer from script doesn't impact access to the buffer from native side. The underlying shared memory will be released by the OS when both native and script side release the buffer.

get_Buffer

The memory address of the shared buffer.

public HRESULT get_Buffer(BYTE ** value)

get_FileMappingHandle

Returns a handle to the file mapping object that backs this shared buffer.

public HRESULT get_FileMappingHandle(HANDLE * value)

The returned handle is owned by the shared buffer object. You should not call CloseHandle on it. Normal app should use Buffer or OpenStream to get memory address or IStream object to access the buffer. For advanced scenarios, you could use file mapping APIs to obtain other views or duplicate this handle to another application process and create a view from the duplicated handle in that process to access the buffer from that separate process.

get_Size

The size of the shared buffer in bytes.

public HRESULT get_Size(UINT64 * value)

OpenStream

Get an IStream object that can be used to access the shared buffer.

public HRESULT OpenStream(IStream ** value)