Метод IMFSourceReader::ReadSample (mfreadwrite.h)

Статья
08/24/2023

Считывает следующий пример из источника мультимедиа.

Синтаксис

HRESULT ReadSample(
  [in]  DWORD     dwStreamIndex,
  [in]  DWORD     dwControlFlags,
  [out] DWORD     *pdwActualStreamIndex,
  [out] DWORD     *pdwStreamFlags,
  [out] LONGLONG  *pllTimestamp,
  [out] IMFSample **ppSample
);

Параметры

[in] dwStreamIndex

Поток для извлечения данных. Значением может быть любое из следующих значений.

Значение	Значение
0–0xFFFFFFFB	Отсчитываемый от нуля индекс потока.
MF_SOURCE_READER_FIRST_VIDEO_STREAM 0xFFFFFFFC	Первый видеопоток.
MF_SOURCE_READER_FIRST_AUDIO_STREAM 0xFFFFFFFD	Первый аудиопоток.
MF_SOURCE_READER_ANY_STREAM 0xFFFFFFFE	Получите следующий доступный пример, независимо от потока.

[in] dwControlFlags

Побитовое ЗНАЧЕНИЕ ИЛИ , равное нулю или более флагам из перечисления MF_SOURCE_READER_CONTROL_FLAG .

[out] pdwActualStreamIndex

Получает отсчитываемый от нуля индекс потока.

[out] pdwStreamFlags

Получает побитовое значение OR , равное нулю или более флагам из перечисления MF_SOURCE_READER_FLAG .

[out] pllTimestamp

Получает метку времени образца или время события потока, указанное в pdwStreamFlags. Время задается в 100-наносекундных единицах.

[out] ppSample

Получает указатель на интерфейс IMFSample или значение NULL (см. примечания). Если этот параметр получает указатель, отличный от NULL , вызывающий объект должен освободить интерфейс.

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
MF_E_INVALIDREQUEST	Недопустимый запрос.
MF_E_INVALIDSTREAMNUMBER	Недопустимый параметр dwStreamIndex .
MF_E_NOTACCEPTING	Операция очистки ожидается. См . статью IMFSourceReader::Flush.
E_INVALIDARG	Недопустимый аргумент. См. заметки.

Этот метод может выполняться синхронно или асинхронно. Если при создании исходного средства чтения указан указатель обратного вызова, метод будет асинхронным. В противном случае метод является синхронным. Дополнительные сведения о настройке указателя обратного вызова см. в разделе MF_SOURCE_READER_ASYNC_CALLBACK.

Асинхронный режим

В асинхронном режиме:

[out] Все параметры должны иметь значение NULL. В противном случае метод возвращает E_INVALIDARG.
Метод возвращает немедленно.
После завершения операции вызывается метод ПРИЛОЖЕНИЯ IMFSourceReaderCallback::OnReadSample .
При возникновении ошибки метод может завершиться синхронным или асинхронным сбоем. Проверьте возвращаемое значение ReadSample, а также проверка параметр hrStatusпараметра IMFSourceReaderCallback::OnReadSample.

Синхронный режим

В синхронном режиме:

Параметры pdwStreamFlags и ppSample не могут иметь значение NULL. В противном случае метод возвращает E_POINTER.
Параметры pdwActualStreamIndex и pllTimestamp могут иметь значение NULL.
Метод блокируется, пока не будет доступен следующий пример.

В синхронном режиме, если параметр dwStreamIndexMF_SOURCE_READER_ANY_STREAM, необходимо передать значение, отличное от NULL , для pdwActualStreamIndex, чтобы узнать, какой поток доставлял пример.

Этот метод может возвращать флаги в параметре pdwStreamFlags , не возвращая пример носителя в ppSample. Поэтому параметр ppSample может получить указатель NULL даже при успешном выполнении метода. Например, когда средство чтения исходного кода достигает конца потока, оно возвращает флаг MF_SOURCE_READERF_ENDOFSTREAM в pdwStreamFlags и задает ppSampleзначение NULL.

Если в потоке есть пробел, pdwStreamFlags получает флаг MF_SOURCE_READERF_STREAMTICK, ppSample имеет значение NULL, а pllTimestamp указывает время возникновения разрыва.

Этот интерфейс доступен в Windows Vista, если установлено дополнение к обновлению платформы для Windows Vista.

Требования

Требование	Значение
Минимальная версия клиента	Дополнение к Windows 7, Windows Vista и обновлению платформы для Windows Vista [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2008 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	mfreadwrite.h

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

IMFSourceReader

Средство чтения исходного кода

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