IContiguousDataStorage::ReadAt: различия между версиями

Материал из CAMaaS preliminary wiki
Перейти к навигации Перейти к поиску
 
Строка 1: Строка 1:
{{function_begin|return_code_t PLATFORM_NATIVE_CALLING_CONVENTION ReadAt( std::uint64_t iOffset,  IInputStream** ppStream) const noexcept; |{{IContiguousDataStorage::ReadAt brief}}}}
{{function_begin|return_code_t PLATFORM_NATIVE_CALLING_CONVENTION ReadAt(std::uint64_t iOffset,  IInputStream** ppStream) const noexcept;|{{IContiguousDataStorage::ReadAt brief}}}}
{{function_paramlist begin}}
{{function_paramlist begin}}
{{function_paramlist add|iOffset|.}}
{{function_paramlist add|iOffset|Сдвиг, количество определенных реализацией элементов данных, позиции внутри накопителя {{cpp_this}}, с которой связывается создаваемый поток данных. Реализация может налагать ограничения на область допустимых значений параметра {{param|iOffset}}.}}
{{function_paramlist add|ppStream|.|paramdir=[out]}}
{{function_paramlist add|ppStream|Выходной указатель, принимающий адрес реализации потока [[IInputStream]]. После успешного вызова метода полученная реализация должна быть освобождена вызовом [[InterfaceBase::Release]] над <source inline lang="cpp">(*ppStream)</source>. Созданный поток связывается с позицией {{param|iOffset}} в накопителе {{cpp_this}}. Типы потока и связанных с ним элементов данных определяются реализацией интерфейса [[IContiguousDataStorage]].|paramdir=[out]}}
{{function_paramlist end}}
{{function_paramlist end}}
{{function_return_value|32-битовый беззнаковый целый код ошибки, который в случае успешного выполнения неотрицателен.}}
{{function_return_value|32-битовый беззнаковый целый код ошибки, который в случае успешного выполнения неотрицателен.}}
{{function_end}}
{{function_end}}

Текущая версия на 19:14, 15 августа 2019

return_code_t PLATFORM_NATIVE_CALLING_CONVENTION ReadAt(std::uint64_t iOffset,  IInputStream** ppStream) const noexcept;

Создает поток чтения, связанный с накопителем данных IContiguousDataStorage, в заданной параметрически позиции в накопителе.

Параметры
iOffsetСдвиг, количество определенных реализацией элементов данных, позиции внутри накопителя this, с которой связывается создаваемый поток данных. Реализация может налагать ограничения на область допустимых значений параметра iOffset.
[out]ppStreamВыходной указатель, принимающий адрес реализации потока IInputStream. После успешного вызова метода полученная реализация должна быть освобождена вызовом InterfaceBase::Release над (*ppStream). Созданный поток связывается с позицией iOffset в накопителе this. Типы потока и связанных с ним элементов данных определяются реализацией интерфейса IContiguousDataStorage.
Возвращаемое значение:
32-битовый беззнаковый целый код ошибки, который в случае успешного выполнения неотрицателен.