forked from eden-emu/eden
72 lines
4.5 KiB
C++
72 lines
4.5 KiB
C++
|
// SPDX-License-Identifier: BSD-2-Clause
|
||
|
|
// Copyright © 2021 Billy Laws
|
||
|
|
|
||
|
|
#pragma once
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
extern "C" {
|
||
|
|
#endif
|
||
|
|
|
||
|
|
#include <stdbool.h>
|
||
|
|
#include "priv.h"
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Opens a new libvulkan.so instance according to `flags`
|
||
|
|
* @remark IMPORTANT: The app MUST be packaged w/ useLegacyPackaging = true. The reason for this is
|
||
|
|
* that we install the hook in hookLibDir; but this folder won't be set correctly when useLegacyPackaging == false
|
||
|
|
* because Android expects to read the *.so directly from the apk (instead of decompressing them into nativeLibraryDir).
|
||
|
|
* @param dlopenMode The dlopen mode to use when opening libvulkan
|
||
|
|
* @param featureFlags Which adrenotools driver features to enable
|
||
|
|
* @param tmpLibDir A writable directory to hold patched libraries, only used on api < 29 due to the lack of memfd support. If nullptr is passed and the API version is < 29 memfd usage will be attempted and if unsupported nullptr will be returned
|
||
|
|
* @param hookLibDir The directory holding the built hooks.
|
||
|
|
* IMPORTANT: This path MUST point to whatever `getApplicationInfo().nativeLibraryDir` (Kotlin code) returns.
|
||
|
|
* Failing to do so will result in this function returning a valid ptr but then the hook will fail and either the original driver is loaded as fallback, or vkEnumeratePhysicalDevices returns 0 devices.
|
||
|
|
* @param customDriverDir The directory to load a custom GPU driver named according to `customDriverName` from. Only used if ADRENOTOOLS_DRIVER_CUSTOM is set in `featureFlags`.
|
||
|
|
* IMPORTANT: This path MUST NOT be on sdcard/storage. i.e. use ANativeActivity::internalDataPath and often looks like "/data/user/0/com.example.app/files/".
|
||
|
|
* Otherwise you will get permission denied because dlopen() can't be done on *.so libraries that any random user or application can manipulate (which would be a security risk).
|
||
|
|
* @param customDriverName The soname of the custom driver to load. Only used if ADRENOTOOLS_DRIVER_CUSTOM is set in `featureFlags`
|
||
|
|
* @param fileRedirectDir The directory which to redirect all file accesses performed by the driver to. Only used if ADRENOTOOLS_DRIVER_FILE_REDIRECT is set in `featureFlags`
|
||
|
|
* @param userMappingHandle A pointer to a void* which will be set to the mapping handle if ADRENOTOOLS_DRIVER_GPU_MAPPING_IMPORT is set in `featureFlags`
|
||
|
|
*/
|
||
|
|
void *adrenotools_open_libvulkan(int dlopenMode, int featureFlags, const char *tmpLibDir, const char *hookLibDir, const char *customDriverDir, const char *customDriverName, const char *fileRedirectDir, void **userMappingHandle);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Imports the given CPU mapped memory range into the GSL allocator. This should then be followed by a call to vkAllocateMemory with a matching size which will return a VkDeviceMemory view over the input region
|
||
|
|
* @param handle Mapping handle that was returned by adrenotools_open_libvulkan
|
||
|
|
* @param hostPtr The host pointer to import
|
||
|
|
* @param size The size of the region to import
|
||
|
|
* @return True on success
|
||
|
|
*/
|
||
|
|
bool adrenotools_import_user_mem(void *handle, void *hostPtr, uint64_t size);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Maps GPU memory and imports it into the GSL allocator. This should then be followed by a call to adrenotools_mem_cpu_map to map the memory on the CPU, then finally vkAllocateMemory with a matching size
|
||
|
|
* @param handle Mapping handle that was returned by adrenotools_open_libvulkan
|
||
|
|
* @param size Pointer to a variable containing the size of the region to import, will be updated to contain the required size of the region to allocate CPU side
|
||
|
|
* @return true on success
|
||
|
|
*/
|
||
|
|
bool adrenotools_mem_gpu_allocate(void *handle, uint64_t *size);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Maps the last mapping allocated using adrenotools_mem_gpu_allocate into the given host memory region, such that vkAllocateMemory can then be called
|
||
|
|
* @param handle Mapping handle that was returned by adrenotools_open_libvulkan
|
||
|
|
* @param hostPtr A pointer to where the mapping should be mapped
|
||
|
|
* @param size The size of the mapping. MUST be equal to the size returned by adrenotools_mem_gpu_allocate
|
||
|
|
*/
|
||
|
|
bool adrenotools_mem_cpu_map(void *handle, void *hostPtr, uint64_t size);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @note This function should be called after adrenotools_open_libvulkan and Vulkan driver init to check if the mapping import hook loaded successfully
|
||
|
|
* @return True if the mapping was successfully imported (or initialization succeeded)
|
||
|
|
*/
|
||
|
|
bool adrenotools_validate_gpu_mapping(void *handle);
|
||
|
|
|
||
|
|
/**
|
||
|
|
* @brief Provides a way to force the GPU to run at the maximum possible clocks (thermal constraints will still be applied)
|
||
|
|
*/
|
||
|
|
void adrenotools_set_turbo(bool turbo);
|
||
|
|
|
||
|
|
#ifdef __cplusplus
|
||
|
|
}
|
||
|
|
#endif
|