Metode IMFAttributes::CopyAllItems (mfobjects.h)

Artikel
02/28/2024

Menyalin semua atribut dari objek ini ke penyimpanan atribut lain.

Sintaks

HRESULT CopyAllItems(
  [in] IMFAttributes *pDest
);

Parameter

[in] pDest

Penunjuk ke antarmuka IMFAttributes dari penyimpanan atribut yang menerima salinan.

Nilai kembali

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

Keterangan

Metode ini menghapus semua atribut yang awalnya disimpan dalam pDest.

Catatan

Saat Anda memanggil CopyAllItems pada IMFSample, yang mewarisi metode ini, waktu sampel, durasi, dan bendera tidak disalin ke sampel tujuan. Anda harus menyalin nilai-nilai ini ke sampel baru secara manual.

Antarmuka ini tersedia pada platform berikut jika komponen yang dapat didistribusikan ulang Windows Media Format 11 SDK diinstal:

Windows XP dengan Paket Layanan 2 (SP2) dan yang lebih baru.
Windows XP Media Center Edition 2005 dengan KB900325 (Windows XP Media Center Edition 2005) dan KB925766 (Rollup Pembaruan Oktober 2006 untuk Windows XP Media Center Edition) terinstal.

Contoh

Untuk menyalin satu atribut daripada semua atribut, Anda dapat menggunakan kode berikut:

HRESULT CopyAttribute(IMFAttributes *pFrom, IMFAttributes *pTo, REFGUID guidKey)
{
    PROPVARIANT val;

    HRESULT hr = pFrom->GetItem(guidKey, &val);

    if (SUCCEEDED(hr))
    {
        hr = pTo->SetItem(guidKey, val);
        PropVariantClear(&val);
    }
    else if (hr == MF_E_ATTRIBUTENOTFOUND)
    {
        hr = S_OK;
    }
    return hr;
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	mfobjects.h (termasuk Mfidl.h)
Pustaka	Mfuuid.lib

Lihat juga

Atribut dan Properti

IMFAttributes

Bagikan melalui