Метод IWMDMDeviceControl::Seek (mswmdm.h)

Статья
08/25/2023

Метод Seek ищет позицию, которая используется в качестве отправной точки методами Play или Record .

Синтаксис

HRESULT Seek(
  [in] UINT fuMode,
  [in] int  nOffset
);

Параметры

[in] fuMode

Режим выполняемой операции поиска. Параметр fuMode должен быть одним из следующих режимов.

Режим	Описание
WMDM_SEEK_BEGIN	Ищите позицию, которая имеет значение nOffset единиц после начала файла.
WMDM_SEEK_CURRENT	Ищите позицию, которая имеет значение nOffset единиц из текущей позиции.
WMDM_SEEK_END	Наведите указатель на позицию, которая имеет значение nOffset единиц перед окончанием файла.
WMDM_SEEK_REMOTECONTROL	Поиск съемного элемента управления.
WMDM_SEEK_STREAMINGAUDIO	Поиск потокового звука.

[in] nOffset

Количество единиц, на которые операция поиска перемещает начальную позицию от источника, заданного fuMode. Единицы nOffset определяются содержимым. Они могут быть миллисекунды для музыки, страницы для электронных книг и т. д.

Положительное значение для nOffset указывает на поиск вперед по файлу. Отрицательное значение указывает на поиск в обратном направлении по файлу. Любое сочетание nOffset и fuMode , указывающее на поиск в позиции до начала файла или после его окончания, является недопустимым и приводит к тому, что метод возвращает E_INVALIDARG.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
E_INVALIDARG	Один или несколько параметров недопустимы.
WMDM_E_NOTSUPPORTED	Поиск не реализован на этом устройстве.
E_FAIL	Произошла неизвестная ошибка.

Позиция поиска определяется путем передачи интерфейса IWMDMStorage , указывающего на расположение на носителе устройства, или интерфейса IWMDMOperation , который был реализован для поддержки потоковой передачи звука. Интерфейс IWMDMObjectInfo также можно передать для описания некоторой точки внутри объекта, на которую указывает указанный интерфейс.

Если для воспроизведения устройства метод Seek не вызывается до воспроизведения, воспроизведение начинается с первой звуковой дорожки на первом носителе носителя.

Для записи устройства операция записи завершается сбоем, если метод Seek не вызывается перед записью. Длину записи можно ограничить, вызвав метод IWMDMObjectInfo::SetPlayLength после возврата из вызова Seek .