Class IUnknownFFM

java.lang.Object

oshi.ffm.ForeignFunctions

oshi.ffm.windows.com.IUnknownFFM

Direct Known Subclasses:

ComObjectFFM

public class IUnknownFFM
extends ForeignFunctions

FFM helpers for the COM IUnknown interface methods AddRef and Release.

All COM interfaces inherit from IUnknown, so vtable slots 1 (AddRef) and 2 (Release) are present on every COM object. QueryInterface (slot 0) is not implemented here.

Field Summary

Fields inherited from class ForeignFunctions

CAPTURE_CALL_STATE, CAPTURED_STATE_LAYOUT, ERRNO_HANDLE, LIBRARY_ARENA, LINKER, NATIVE_LONG_SIZE, NATIVE_POINTER_SIZE, NATIVE_SIZE_T_SIZE, SYMBOL_LOOKUP

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	IUnknownFFM()

Method Summary

Modifier and Type	Method	Description
static int	addRef(MemorySegment pObject, Arena arena)	Increments the reference count of a COM object.
static int	release(MemorySegment pObject, Arena arena)	Decrements the reference count of a COM object.
static void	safeRelease(MemorySegment pObject, Arena arena)	Safely releases a COM object, ignoring null pointers.

Methods inherited from class ForeignFunctions

downcall, getByteArrayFromNativePointer, getErrno, getStringFromNativePointer, getStructFromNativePointer, lib, libraryLookup

Methods inherited from class Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

IUnknownFFM

protected IUnknownFFM()

Method Details

addRef

public static int addRef(MemorySegment pObject,
 Arena arena)

Increments the reference count of a COM object.

Parameters:

pObject - the COM object

arena - the arena for vtable access

Returns:

the new reference count

release

public static int release(MemorySegment pObject,
 Arena arena)

Decrements the reference count of a COM object.

Parameters:

pObject - the COM object

arena - the arena for vtable access

Returns:

the new reference count

safeRelease

public static void safeRelease(MemorySegment pObject,
 Arena arena)

Safely releases a COM object, ignoring null pointers.

Parameters:

pObject - the COM object to release

arena - the arena for vtable access