Функция MFInitVideoFormat (mfapi.h)

Статья
08/24/2023

[Этот API не поддерживается и может быть изменен или недоступен в будущем. Приложения должны избегать использования структуры MFVIDEOFORMAT и использовать атрибуты типа мультимедиа. Дополнительные сведения см. в разделе Типы видеофайла.]

Инициализирует структуру MFVIDEOFORMAT для стандартного видеоформата, такого как DVD, аналоговое телевидение или цифровое телевидение ATSC.

Синтаксис

HRESULT MFInitVideoFormat(
  [out] MFVIDEOFORMAT         *pVideoFormat,
  [in]  MFStandardVideoFormat type
);

Параметры

[out] pVideoFormat

Указатель на структуру MFVIDEOFORMAT . Функция заполняет элементы структуры на основе формата видео, указанного в параметре type.

[in] type

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

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

Если эта функция выполняется успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Примечание До Windows 7 эта функция экспортирована из evr.dll. Начиная с Windows 7 эта функция экспортируется из mfplat.dll, а evr.dll экспортирует функцию-заглушку, которая вызывает mfplat.dll. Дополнительные сведения см . в статье Изменения библиотеки в Windows 7.

Примеры

В следующем примере создается объект типа мультимедиа для стандартного формата видео.

// Creates a media type for a standard video format.
HRESULT CreateStandardVideoMediaType(MFStandardVideoFormat type, IMFMediaType **ppMediaType)
{
    IMFMediaType *pMediaType = NULL;

    MFVIDEOFORMAT format;

    // Fill in the MFVIDEOFORMAT structure for the video format.
    HRESULT hr = MFInitVideoFormat(&format, type);
    if (FAILED(hr))
    {
        goto done;
    }

    // Create a new (empty) media type.
    hr = MFCreateMediaType(&pMediaType);
    if (FAILED(hr))
    {
        goto done;
    }

    // Initialize the media type from the MFVIDEOFORMAT structure.
    hr = MFInitMediaTypeFromMFVideoFormat(pMediaType, &format, sizeof(format));
    if (FAILED(hr))
    {
        goto done;
    }

    // Return the pointer to the caller.
    *ppMediaType = pMediaType;
    (*ppMediaType)->AddRef();

done:
    SafeRelease(&pMediaType);
    return hr;
}

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	mfapi.h
Библиотека	Evr.lib
DLL	Mfplat.dll

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

Функции Media Foundation

Типы носителей

Типы видеофайла

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