Share via

Метод IMFCaptureSource::GetAvailableDeviceMediaType (mfcaptureengine.h)

  • Статья

Возвращает формат, поддерживаемый одним из потоков записи.

Синтаксис

HRESULT GetAvailableDeviceMediaType(
  [in] DWORD        dwSourceStreamIndex,
  [in] DWORD        dwMediaTypeIndex,
  [in] IMFMediaType **ppMediaType
);

Параметры

[in] dwSourceStreamIndex

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

Значение Значение
0–0xFFFFFFFB
 Отсчитываемый от нуля индекс потока. Чтобы получить количество потоков, вызовите IMFCaptureSource::GetDeviceStreamCount.
MF_CAPTURE_ENGINE_FIRST_SOURCE_PHOTO_STREAM
0xFFFFFFFB
 Первый поток изображения.
MF_CAPTURE_ENGINE_FIRST_SOURCE_VIDEO_STREAM
0xFFFFFFFC
 Первый видеопоток.
MF_CAPTURE_ENGINE_FIRST_SOURCE_AUDIO_STREAM
0xFFFFFFFD
 Первый аудиопоток.

[in] dwMediaTypeIndex

Отсчитываемый от нуля индекс извлекаемого типа мультимедиа.

[in] ppMediaType

Получает указатель на интерфейс IMFMediaType . Вызывающий объект должен освободить интерфейс .

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

Этот метод может возвращать одно из этих значений.

Код возврата Описание
S_OK
 Успешно.
MF_E_INVALIDSTREAMNUMBER
 Недопустимый параметр dwSourceStreamIndex .
MF_E_NO_MORE_TYPES
 Параметр dwMediaTypeIndex выходит за пределы диапазона.

Комментарии

Чтобы перечислить все доступные форматы в потоке, вызовите этот метод в цикле при приращении dwMediaTypeIndex, пока метод не вернет MF_E_NO_MORE_TYPES.

Некоторые камеры могут поддерживать диапазон частот кадров. Минимальная и максимальная частота кадров хранятся в атрибутах MF_MT_FRAME_RATE_RANGE_MIN и MF_MT_FRAME_RATE_RANGE_MAX в типе мультимедиа.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header mfcaptureengine.h

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

IMFCaptureSource