device.h

Go to the documentation of this file.

/*
 * Copyright (c) 2024 - 2026 QDMI Maintainers
 * All rights reserved.
 *
 * Licensed under the Apache License v2.0 with LLVM Exceptions (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 * https://llvm.org/LICENSE.txt
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 *
 * SPDX-License-Identifier: Apache-2.0 WITH LLVM-exception
 */

 
#pragma once
 
#include "qdmi/constants.h" // IWYU pragma: export
#include "qdmi/export.h"    // IWYU pragma: export
#include "qdmi/types.h"     // IWYU pragma: export
 
#ifdef __cplusplus
#include <cstddef>
 
extern "C" {
#else
#include <stddef.h>
#endif
 
// The following clang-tidy warning cannot be addressed because this header is
// used from both C and C++ code.
// NOLINTBEGIN(performance-enum-size,modernize-use-using,modernize-redundant-void-arg)


QDMI_EXPORT int QDMI_device_initialize(void);

QDMI_EXPORT int QDMI_device_finalize(void);


typedef struct QDMI_Device_Session_impl_d *QDMI_Device_Session;

QDMI_EXPORT int QDMI_device_session_alloc(QDMI_Device_Session *session);

QDMI_EXPORT int
QDMI_device_session_set_parameter(QDMI_Device_Session session,
                                  QDMI_Device_Session_Parameter param,
                                  size_t size, const void *value);

QDMI_EXPORT int QDMI_device_session_init(QDMI_Device_Session session);

QDMI_EXPORT void QDMI_device_session_free(QDMI_Device_Session session);
 // end of device_session_interface


QDMI_EXPORT int QDMI_device_session_query_device_property(
    QDMI_Device_Session session, QDMI_Device_Property prop, size_t size,
    void *value, size_t *size_ret);

QDMI_EXPORT int QDMI_device_session_query_program_features(
    QDMI_Device_Session session, const QDMI_Program_Format *format, size_t size,
    QDMI_Program_Feature *value, size_t *size_ret);

QDMI_EXPORT int QDMI_device_session_query_site_property(
    QDMI_Device_Session session, QDMI_Site site, QDMI_Site_Property prop,
    size_t size, void *value, size_t *size_ret);

QDMI_EXPORT int QDMI_device_session_query_operation_property(
    QDMI_Device_Session session, QDMI_Operation operation, size_t num_sites,
    const QDMI_Site *sites, size_t num_params, const double *params,
    QDMI_Operation_Property prop, size_t size, void *value, size_t *size_ret);
 // end of device_query_interface


typedef struct QDMI_Device_Job_impl_d *QDMI_Device_Job;

QDMI_EXPORT int
QDMI_device_session_create_device_job(QDMI_Device_Session session,
                                      QDMI_Device_Job *job);

QDMI_EXPORT int QDMI_device_session_retrieve_device_job_by_id(
    QDMI_Device_Session session, const char *job_id, QDMI_Device_Job *job);

QDMI_EXPORT int QDMI_device_job_set_parameter(QDMI_Device_Job job,
                                              QDMI_Device_Job_Parameter param,
                                              size_t size, const void *value);

QDMI_EXPORT int QDMI_device_job_set_programs(QDMI_Device_Job job,
                                             const QDMI_Program_Format *format,
                                             size_t count, const size_t *sizes,
                                             const void *const *programs);

QDMI_EXPORT int QDMI_device_job_query_property(QDMI_Device_Job job,
                                               QDMI_Device_Job_Property prop,
                                               size_t size, void *value,
                                               size_t *size_ret);

QDMI_EXPORT int QDMI_device_job_submit(QDMI_Device_Job job);

QDMI_EXPORT int QDMI_device_job_cancel(QDMI_Device_Job job);

QDMI_EXPORT int QDMI_device_job_check(QDMI_Device_Job job,
                                      QDMI_Job_Status *status);

QDMI_EXPORT int QDMI_device_job_wait(QDMI_Device_Job job, size_t timeout);

QDMI_EXPORT int QDMI_device_job_get_results(QDMI_Device_Job job,
                                            size_t program_index,
                                            QDMI_Job_Result result, size_t size,
                                            void *data, size_t *size_ret);

QDMI_EXPORT void QDMI_device_job_free(QDMI_Device_Job job);
 // end of device_job_interface

typedef struct QDMI_Child_Device_impl_d *QDMI_Child_Device;
 // end of device_interface
 
// NOLINTEND(performance-enum-size,modernize-use-using,modernize-redundant-void-arg)
 
#ifdef __cplusplus
} // extern "C"
#endif