IInMemoryDataStorageInput::GetPtr

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

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

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