Operator Reference

HALCON Operator Reference / System / Memory Block
ClassesClasses | | Operators

get_memory_block_ptrT_get_memory_block_ptrGetMemoryBlockPtrGetMemoryBlockPtrget_memory_block_ptr (Operator)

get_memory_block_ptrT_get_memory_block_ptrGetMemoryBlockPtrGetMemoryBlockPtrget_memory_block_ptr — Return the data pointer and size of a memory block.

Warning

It is not recommended to use the operator get_memory_block_ptrget_memory_block_ptrGetMemoryBlockPtrGetMemoryBlockPtrget_memory_block_ptr in HDevelop.

Signature

get_memory_block_ptr( : : MemoryBlockHandle : Pointer, Size)

Herror T_get_memory_block_ptr(const Htuple MemoryBlockHandle, Htuple* Pointer, Htuple* Size)

void GetMemoryBlockPtr(const HTuple& MemoryBlockHandle, HTuple* Pointer, HTuple* Size)

void* HMemoryBlock::GetMemoryBlockPtr(Hlong* Size) const

static void HOperatorSet.GetMemoryBlockPtr(HTuple memoryBlockHandle, out HTuple pointer, out HTuple size)

IntPtr HMemoryBlock.GetMemoryBlockPtr(out int size)

def get_memory_block_ptr(memory_block_handle: HHandle) -> Tuple[int, int]

Description

get_memory_block_ptrget_memory_block_ptrGetMemoryBlockPtrGetMemoryBlockPtrget_memory_block_ptr returns the data pointer to the beginning of a memory block in PointerPointerPointerpointerpointer and its size in bytes in SizeSizeSizesizesize. MemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle is the handle of the memory block.

Execution Information

  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).
  • Multithreading scope: global (may be called from any thread).
  • Processed without parallelization.

Parameters

MemoryBlockHandleMemoryBlockHandleMemoryBlockHandlememoryBlockHandlememory_block_handle (input_control)  memory_block → HMemoryBlock, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the memory block.

PointerPointerPointerpointerpointer (output_control)  pointer → HTupleintHTupleHtuple (integer) (IntPtr) (Hlong) (Hlong)

Data pointer to the beginning of the memory block.

SizeSizeSizesizesize (output_control)  integer → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Size of the memory block.

Result

If the parameters are valid, the operator get_memory_block_ptrget_memory_block_ptrGetMemoryBlockPtrGetMemoryBlockPtrget_memory_block_ptr returns the value 2 ( H_MSG_TRUE) . If necessary, an exception is raised.

Possible Predecessors

create_memory_block_externcreate_memory_block_externCreateMemoryBlockExternCreateMemoryBlockExterncreate_memory_block_extern, create_memory_block_extern_copycreate_memory_block_extern_copyCreateMemoryBlockExternCopyCreateMemoryBlockExternCopycreate_memory_block_extern_copy, image_to_memory_blockimage_to_memory_blockImageToMemoryBlockImageToMemoryBlockimage_to_memory_block, read_memory_blockread_memory_blockReadMemoryBlockReadMemoryBlockread_memory_block

Module

Foundation

ClassesClasses | | Operators