Fungsi CopyMediaType

Artikel
07/28/2023

[Fitur yang terkait dengan halaman ini, DirectShow, adalah fitur warisan. Ini telah digantikan oleh MediaPlayer, IMFMediaEngine, dan Pengambilan Audio/Video di Media Foundation. Fitur-fitur tersebut telah dioptimalkan untuk Windows 10 dan Windows 11. Microsoft sangat menyarankan agar kode baru menggunakan MediaPlayer, IMFMediaEngine , dan Pengambilan Audio/Video di Media Foundation alih-alih DirectShow, jika memungkinkan. Microsoft menyarankan agar kode yang ada yang menggunakan API warisan ditulis ulang untuk menggunakan API baru jika memungkinkan.]

Fungsi CopyMediaType menyalin struktur AM_MEDIA_TYPE ke struktur lain, termasuk blok format

Sintaks

HRESULT WINAPI CopyMediaType(
         AM_MEDIA_TYPE *pmtTarget,
   const AM_MEDIA_TYPE *pmtSource
);

Parameter

pmtTarget: Arahkan ke struktur AM_MEDIA_TYPE . Metode menyalin jenis media ke dalam struktur ini.
pmtSource: Arahkan ke struktur AM_MEDIA_TYPE sumber untuk disalin.

Nilai kembali

Mengembalikan S_OK atau E_OUTOFMEMORY.

Keterangan

Fungsi ini mengalokasikan memori untuk blok format. Jika parameter pmtTarget sudah berisi blok format yang dialokasikan, kebocoran memori akan terjadi. Untuk menghindari kebocoran memori, panggil FreeMediaType sebelum memanggil fungsi ini.

Setelah metode kembali, panggil FreeMediaType di pmtTarget untuk membebaskan blok format.

Persyaratan

Persyaratan	Nilai
Header	Mtype.h (termasuk Streams.h)
Pustaka	Strmbase.lib (build ritel); Strmbasd.lib (build debug)

Lihat juga

Fungsi Jenis Media

Bagikan melalui