IInMemoryDataStorage::GetPtr

Материал из CAMaaS preliminary wiki
Перейти к навигации Перейти к поиску
return_code_t PLATFORM_NATIVE_CALLING_CONVENTION GetPtr(void** ppBuffer, std::size_t* pcbBuffer) noexcept;

Возвращает адрес управляемого накопителем буфера данных в памяти.

Параметры
[out]ppBufferВ результате успешного выполнения функции получает адрес буфера памяти, управляемого накопителем.
[out]pcbBufferОпциональный указатель, который принимает байтовый размер буфера *ppBuffer. Клиенту разрешено адресовать и осуществлять чтение и запись в буфер [(uint8_t) *ppBuffer, (uint8_t) *ppBuffer + *pcbBuffer) при условии соблюдения им ограничений, налагаемых реализацией на совместный ввод-вывод, если он осуществляется клиентом. Выходное значение параметра pcbBuffer не является длиной фактически имеющихся данных в буфере, часть буфера может быть неинициализирована. Для получения размера данных в накопителе требуется использовать методы GetByteSize и GetElementCount, наследуемые у интерфейса IContiguousDataStorage.
Возвращаемое значение:
32-битовый беззнаковый целый код ошибки, который в случае успешного выполнения неотрицателен.