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


Метод IAsyncReader::SyncReadAligned (strmif.h)

[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует использовать в новом коде MediaPlayer, IMFMediaEngine и аудио/видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, в котором используются устаревшие API, чтобы по возможности использовать новые API.]

Метод SyncReadAligned выполняет синхронное чтение. Метод блокируется до завершения запроса. Позиции файлов и адрес буфера должны быть выровнены; проверка свойства распределителя для требуемого выравнивания.

Синтаксис

HRESULT SyncReadAligned(
  IMediaSample *pSample
);

Параметры

pSample

Указатель на интерфейс IMediaSample примера мультимедиа, предоставленного вызывающим элементом.

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

Возвращает значение HRESULT . Ниже приведены возможные значения.

Код возврата Описание
VFW_E_BADALIGN
Недопустимое выравнивание.
S_FALSE
Получено меньше байтов, чем запрошено. (Вероятно, достигнут конец файла.)
S_OK
Успешно.

Комментарии

Перед вызовом этого метода получите образец носителя из распределителя контакта. Метка времени выборки со смещением байтов, которые вы запрашиваете, первый и последний включительно, умноженные на 10 000 000. Смещения байтов относятся к началу потока.

Начальная и стоповая позиции должны соответствовать выравниванию, которое было определено при соединении контактов. В противном случае метод возвращает VFW_E_BADALIGN. Если согласованное выравнивание является более грубым, чем фактическое выравнивание потока, позиция остановки может превысить реальную длительность. Если это так, метод округляет позицию остановки до фактического выравнивания.

Этот метод выполняет чтение без буффефера, поэтому он может быть быстрее, чем метод IAsyncRead::SyncRead .

Требования

Требование Значение
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header strmif.h (включая Dshow.h)
Библиотека Strmiids.lib

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

Коды ошибок и успешности

Интерфейс IAsyncReader