template <>

class NaturalClientImpl

Defined at line 1295 of file fidling/gen/sdk/fidl/fuchsia.gpu.magma/fuchsia.gpu.magma/cpp/fidl/fuchsia.gpu.magma/cpp/natural_messaging.h

Public Methods

::fidl::internal::NaturalThenable< ::fuchsia_gpu_magma::Primary::Flush> Flush ()

Incurs a round-trip to the system driver, used to ensure all previous messages have been

observed, but not necessarily completed.

::fidl::internal::NaturalThenable< ::fuchsia_gpu_magma::Primary::IsPerformanceCounterAccessAllowed> IsPerformanceCounterAccessAllowed ()

Returns true if any EnablePerformanceCounterAccess message has succeeded.

::fit::result< ::fidl::OneWayError> ImportObject (::fidl::Request< ::fuchsia_gpu_magma::Primary::ImportObject> request)

Imports an object for use in the system driver.

::fit::result< ::fidl::OneWayError> ReleaseObject (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::ReleaseObject> & request)

Destroys the object with `object_id` within this connection.

::fit::result< ::fidl::OneWayError> CreateContext (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::CreateContext> & request)

Creates context `context_id` for use in command execution. A context may be associated

with hardware state.

DEPRECATED: Please use CreateContext2.

TODO(https://fxbug.dev/413030654): Fully deprecate this API.

::fit::result< ::fidl::OneWayError> CreateContext2 (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::CreateContext2> & request)

Creates context `context_id` for use in command execution. A context may be associated

with hardware state.

::fit::result< ::fidl::OneWayError> DestroyContext (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::DestroyContext> & request)

Destroys context `context_id`.

::fit::result< ::fidl::OneWayError> ExecuteCommand (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::ExecuteCommand> & request)

Submits command buffers for execution on the hardware, with associated `resources`.

`resources` must refer to buffers that have been imported.

`wait_semaphores` and `signal_semaphores` must refer to events that have been imported.

`wait_semaphores` must all be signaled before execution begins, then are reset.

`signal_semaphores` will be signaled after the command buffer is completed.

::fit::result< ::fidl::OneWayError> ExecuteInlineCommands (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::ExecuteInlineCommands> & request)

Submits a series of commands for execution on the hardware without using a command buffer.

The number of commands sent should be calculated so that the total message size is less than

MAX_INLINE_COMMANDS_DATA_SIZE.

::fit::result< ::fidl::OneWayError> MapBuffer (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::MapBuffer> & request)

Maps a page range onto the hardware in the connection's address space at address `hw_va`.

`flags` is a set of flags from MapFlags that specify how the hardware can access the buffer.

::fit::result< ::fidl::OneWayError> UnmapBuffer (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::UnmapBuffer> & request)

Releases the mapping at address `hw_va` from the hardware for the given `buffer_id`.

Buffers will also be implicitly unmapped when released.

::fit::result< ::fidl::OneWayError> BufferRangeOp2 (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::BufferRangeOp2> & request)

Perform an operation on a range of the buffer.

::fit::result< ::fidl::OneWayError> EnableFlowControl ()

Enables the events OnNotifyMessagesConsumed and OnNotifyMemoryImported.

::fit::result< ::fidl::OneWayError> EnablePerformanceCounterAccess (::fidl::Request< ::fuchsia_gpu_magma::Primary::EnablePerformanceCounterAccess> request)

Tries to enable performance counter FIDL messages. To be successful, |access_token| must

have been returned by PerformanceCounterAccess.GetPerformanceCountToken() from the matching

device.

::fit::result< ::fidl::OneWayError> EnablePerformanceCounters (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::EnablePerformanceCounters> & request)

Enables a set of performance counters. Disables enabled performance counters that are not

in the new set. Performance counters will also be automatically disabled on connection

close. Performance counter access must have been enabled using

EnablePerformanceCounterAccess before calling this method.

::fit::result< ::fidl::OneWayError> CreatePerformanceCounterBufferPool (::fidl::Request< ::fuchsia_gpu_magma::Primary::CreatePerformanceCounterBufferPool> request)

Creates a pool of buffers that performance counters can be dumped into. Performance counter

access must have been enabled using EnablePerformanceCounterAccess before calling this

method.

::fit::result< ::fidl::OneWayError> ReleasePerformanceCounterBufferPool (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::ReleasePerformanceCounterBufferPool> & request)

Releases a pool of performance counter buffers. Performance counter access must have been

enabled using EnablePerformanceCounterAccess before calling this method.

::fit::result< ::fidl::OneWayError> AddPerformanceCounterBufferOffsetsToPool (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::AddPerformanceCounterBufferOffsetsToPool> & request)

Adds a set of offsets into buffers to the pool. |offsets[n].buffer_id| is the id of a

buffer that was previously imported using ImportBuffer(). The same buffer may be added to

multiple pools. The pool will hold on to a reference to the buffer even after ReleaseBuffer

is called. When dumped into this entry, counters will be written starting at

|offsets[n].buffer_offset| bytes into the buffer, and up to |offsets[n].buffer_offset| +

|offsets[n].buffer_size|. |offsets[n].buffer_size| must be large enough to fit all enabled

counters. Performance counter access must have been enabled using

EnablePerformanceCounterAccess before calling this method.

::fit::result< ::fidl::OneWayError> RemovePerformanceCounterBufferFromPool (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::RemovePerformanceCounterBufferFromPool> & request)

Removes every offset of a buffer from the pool. Once this method is finished being handled

on the server, no more dumps will be processed into this buffer. In-flight dumps into this

buffer may be lost. Performance counter access must have been enabled using

EnablePerformanceCounterAccess before calling this method.

::fit::result< ::fidl::OneWayError> DumpPerformanceCounters (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::DumpPerformanceCounters> & request)

Triggers dumping of the performance counters into a buffer pool. May fail silently if there

are no buffers in the pool. |trigger_id| is an arbitrary ID assigned by the client that can

be returned in OnPerformanceCounterReadCompleted. Performance counter access must have been

enabled using EnablePerformanceCounterAccess before calling this method.

::fit::result< ::fidl::OneWayError> ClearPerformanceCounters (const ::fidl::Request< ::fuchsia_gpu_magma::Primary::ClearPerformanceCounters> & request)

Sets the values of all listed performance counters to 0. May not be supported by some

hardware. Performance counter access must have been enabled using

EnablePerformanceCounterAccess before calling this method.