METODE IMFSinkWriter::P laceMarker (mfreadwrite.h)

Artikel
02/28/2024

Places penanda di aliran yang ditentukan.

Sintaks

HRESULT PlaceMarker(
  [in] DWORD  dwStreamIndex,
  [in] LPVOID pvContext
);

Parameter

[in] dwStreamIndex

Indeks aliran berbasis nol.

[in] pvContext

Penunjuk ke nilai yang ditentukan aplikasi. Nilai parameter ini dikembalikan ke pemanggil dalam parameter pvContext dari metode panggilan balik IMFSinkWriterCallback::OnMarker penelepon. Aplikasi bertanggung jawab atas alokasi memori apa pun yang terkait dengan data ini. Parameter ini bisa NULL.

Nilai kembali

Metode mengembalikan HRESULT. Nilai yang mungkin termasuk, tetapi tidak terbatas pada, yang ada dalam tabel berikut.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
MF_E_INVALIDREQUEST	Permintaan tidak valid.

Keterangan

Untuk menggunakan metode ini, Anda harus memberikan panggilan balik asinkron saat membuat penulis sink. Jika tidak, metode mengembalikan MF_E_INVALIDREQUEST. Untuk informasi selengkapnya, lihat MF_SINK_WRITER_ASYNC_CALLBACK.

Penanda menyediakan cara untuk diberi tahu ketika sink media mengonsumsi semua sampel dalam aliran hingga titik tertentu. Sink media tidak memproses penanda sampai telah memproses semua sampel yang datang sebelum penanda. Ketika sink media memproses penanda, penulis sink memanggil metode OnMarker aplikasi. Ketika panggilan balik dipanggil, Anda tahu bahwa sink telah menggunakan semua sampel sebelumnya untuk aliran tersebut.

Misalnya, untuk mengubah format midstream, panggil PlaceMarker di titik di mana format berubah. Ketika OnMarker dipanggil, aman untuk memanggil IMFSinkWriter::SetInputMediaType untuk mengubah jenis input (dengan asumsi bahwa sink media mendukung perubahan format dinamis).

Secara internal, metode ini memanggil IMFStreamSink::P laceMarker di sink media.

Catatan Parameter pvContext dari metode IMFSinkWriter::P laceMarker tidak diteruskan ke parameter pvarContextValue dari metode IMFStreamSink::P laceMarker . Kedua parameter ini tidak terkait langsung.

Antarmuka ini tersedia pada Windows Vista jika Pelengkap Pembaruan Platform untuk Windows Vista diinstal.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 7, Windows Vista, dan Suplemen Pembaruan Platform untuk Windows Vista [aplikasi desktop \| Aplikasi UWP]
Server minimum yang didukung	Windows Server 2008 R2 [aplikasi desktop \| Aplikasi UWP]
Target Platform	Windows
Header	mfreadwrite.h

Lihat juga

IMFSinkWriter

Penulis Sink

Bagikan melalui