Метод IPortableDeviceUnitsStream::SeekInUnits (portabledeviceapi.h)

Статья
03/15/2023

Метод SeekInUnits выполняет поиск в потоке на основе альтернативных единиц.

Синтаксис

HRESULT SeekInUnits(
  [in]            LARGE_INTEGER    dlibMove,
  [in]            WPD_STREAM_UNITS units,
  [in]            DWORD            dwOrigin,
  [out, optional] ULARGE_INTEGER   *plibNewPosition
);

Параметры

[in] dlibMove

Смещение, добавляемое в расположение, указанное параметром dwOrigin . Единицы смещения задаются единицами. Если dwOriginSTREAM_SEEK_SET, это интерпретируется как неподписаемое значение, а не как подписанное значение.

[in] units

Единицы измерения параметров dlibMove и plibNewPosition . Дополнительные сведения см. в разделе WPD_STREAM_UNITS .

[in] dwOrigin

Источник смещения, указанного в dlibMove. Источником может быть начало файла (STREAM_SEEK_SET), текущий указатель поиска (STREAM_SEEK_CUR) или конец файла (STREAM_SEEK_END). Дополнительные сведения о значениях см. в перечислении STREAM_SEEK .

[out, optional] plibNewPosition

Указатель на расположение, в котором этот метод записывает значение нового указателя поиска с начала потока. Единицы измерения задаются по единицам. Для этого указателя можно задать значение NULL. В этом случае этот метод не предоставляет новый указатель поиска.

Возвращаемое значение

Метод возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Указатель поиска успешно отрегулирован.
STG_E_INVALIDPOINTER	Указывает, что параметр [out] plibNewPosition указывает на недопустимую память, так как plibNewPosition не считывается.
STG_E_INVALIDFUNCTION	Параметр dwUnits или dwOrigin содержит недопустимое значение, или параметр dlibMove содержит неправильное значение смещения. Например, результатом указателя поиска является отрицательное значение смещения.

Требования


Минимальная версия клиента	Windows 8 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Ни одна версия не поддерживается
Целевая платформа	Windows
Header	portabledeviceapi.h
Библиотека	PortableDeviceGUIDs.lib

См. также раздел

IPortableDeviceUnitsStream

WPD_STREAM_UNITS

Поделиться через