Fungsi MFInitVideoFormat (mfapi.h)

Artikel
08/24/2023

[API ini tidak didukung dan dapat diubah atau tidak tersedia di masa mendatang. Aplikasi harus menghindari penggunaan struktur MFVIDEOFORMAT , dan menggunakan atribut jenis media sebagai gantinya. Untuk informasi selengkapnya, lihat Tipe Media Video.]

Menginisialisasi struktur MFVIDEOFORMAT untuk format video standar seperti DVD, televisi analog, atau televisi digital ATSC.

Sintaks

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

Parameter

[out] pVideoFormat

Penunjuk ke struktur MFVIDEOFORMAT . Fungsi mengisi anggota struktur berdasarkan format video yang ditentukan dalam parameter jenis.

[in] type

Format video, ditentukan sebagai anggota enumerasi MFStandardVideoFormat .

Menampilkan nilai

Jika fungsi ini berhasil, fungsi akan mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT akan dikembalikan.

Keterangan

Catatan Sebelum Windows 7, fungsi ini diekspor dari evr.dll. Mulai dari Windows 7, fungsi ini diekspor dari mfplat.dll, dan evr.dll mengekspor fungsi stub yang memanggil ke mfplat.dll. Untuk informasi selengkapnya, lihat Perubahan Pustaka di Windows 7.

Contoh

Contoh berikut membuat objek jenis media untuk format video standar.

// 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;
}

Persyaratan


Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	mfapi.h
Pustaka	Evr.lib
DLL	Mfplat.dll

Lihat juga

Fungsi Media Foundation

Jenis Media

Tipe Media Video

Bagikan melalui