IInputStream::Read: различия между версиями
Перейти к навигации
Перейти к поиску
| Строка 1: | Строка 1: | ||
{{function_begin|return_code_t PLATFORM_NATIVE_CALLING_CONVENTION Read( void* pElement) | {{function_begin|return_code_t PLATFORM_NATIVE_CALLING_CONVENTION Read( void* pElement) noexcept; |{{IInputStream::Read brief}}}} | ||
{{function_paramlist begin}} | {{function_paramlist begin}} | ||
{{function_paramlist add|pElement|Выходной указатель на один элемент, приведенный к общему виду. Предполагается осведомленность клиента о типе элемента - это либо скалярный тип, либо [[Программный интерфейс|интерфейс]]. Если элементом является скалярный тип, метод принимает указатель на неинициализированное значение. Если элементом является интерфейс, то в качестве параметра задается указатель, значению которого методом присваивается адрес реализации интерфейса, которую нужно закрывать с помощью ее метода [[InterfaceBase::Release|Release]].|paramdir=[out]}} | {{function_paramlist add|pElement|Выходной указатель на один элемент, приведенный к общему виду. Предполагается осведомленность клиента о типе элемента - это либо скалярный тип, либо [[Программный интерфейс|интерфейс]]. Если элементом является скалярный тип, метод принимает указатель на неинициализированное значение. Если элементом является интерфейс, то в качестве параметра задается указатель, значению которого методом присваивается адрес реализации интерфейса, которую нужно закрывать с помощью ее метода [[InterfaceBase::Release|Release]].|paramdir=[out]}} | ||
Текущая версия на 18:24, 25 августа 2019
return_code_t PLATFORM_NATIVE_CALLING_CONVENTION Read( void* pElement) noexcept;
Считывает из потока один элемент.
- Параметры
[out] pElement Выходной указатель на один элемент, приведенный к общему виду. Предполагается осведомленность клиента о типе элемента - это либо скалярный тип, либо интерфейс. Если элементом является скалярный тип, метод принимает указатель на неинициализированное значение. Если элементом является интерфейс, то в качестве параметра задается указатель, значению которого методом присваивается адрес реализации интерфейса, которую нужно закрывать с помощью ее метода Release. - Возвращаемое значение:
- 32-битовый беззнаковый целый код ошибки, который в случае успешного выполнения неотрицателен. Если элемент успешно считан возвращается CHSVERROR_SUCCESS (0x20000000). Если элемент считать не удалось по причине отсутствия в потоке элементов, возвращается CHSVERROR_SUCCESS_FALSE (0x20000001). Также реализация может определять дополнительные коды успешного завершения, при которых данные будут считаны не полностью. В случае, если возвращается код успешного завершения операции, отличный от CHSVERROR_SUCCESS (0x20000000), результат последующих попыток считывания из потока на уровне абстракции IInputStream не определен.