Metode IKsInterfaceHandler::KsCompleteIo (ksproxy.h)

Artikel
02/26/2024

Metode KsCompleteIo membersihkan header yang diperluas dan merilis sampel media setelah input dan output (I/O) selesai.

Sintaks

HRESULT KsCompleteIo(
  [in, out] PKSSTREAM_SEGMENT StreamSegment
);

Parameter

[in, out] StreamSegment

Penunjuk ke struktur KSSTREAM_SEGMENT yang berisi informasi header untuk menyelesaikan segmen aliran.

Nilai kembali

Mengembalikan NOERROR jika berhasil; jika tidak, mengembalikan kode kesalahan.

Keterangan

Metode KsCompleteIo membuang memori yang dialokasikan, memperbarui sampel media, dan mengurangi jumlah item tunggu untuk proksi.

Metode KsCompleteIo harus menentukan jenis operasi I/O yang diselesaikan oleh metode IKsInterfaceHandler::KsProcessMediaSamples dari anggota IoOperation dari struktur KSSTREAM_SEGMENT. Jika operasi I/O membaca data dari aliran (KsIoOperation_Read jenis enumerasi KSIOOPERATION), KsCompleteIo melakukan tindakan berikut untuk mengirimkan sampel dari pin output ke pin input yang terhubung:

Mencerminkan informasi header aliran di antarmuka IMediaSample .
Memanggil metode IKsPin::KsDeliver dari pin output untuk mengirimkan sampel. KsDeliver merilis sampel sehingga saat mengantre buffer ke perangkat, sampel dapat diambil jika itu adalah sampel terakhir. Pin input kemudian melengkapi I/O dan aman untuk melepaskan sampel.

Untuk informasi selengkapnya tentang IMediaSample, lihat dokumentasi Microsoft Windows SDK.