Fungsi KsPinGetAvailableByteCount (ks.h)

Artikel
02/26/2024

KsPinGetAvailableByteCount secara rutin menghasilkan jumlah byte data input di depan tepi depan dan jumlah byte buffer output di depan tepi terdepan, baik untuk antrean pin yang ditentukan penelepon.

Sintaks

KSDDKAPI NTSTATUS KsPinGetAvailableByteCount(
  [in]            PKSPIN Pin,
  [out, optional] PLONG  InputDataBytes,
  [out, optional] PLONG  OutputBufferBytes
);

Parameter

[in] Pin

Penunjuk ke struktur KSPIN untuk menghitung parameter antrean ini.

[out, optional] InputDataBytes

Penunjuk ke nilai LONG di mana rutinitas mengembalikan jumlah byte data input di depan tepi terkemuka. Pemanggil diatur ke NULL jika nilai ini tidak diminta.

[out, optional] OutputBufferBytes

Penunjuk ke nilai LONG di mana rutinitas mengembalikan jumlah byte buffer output di depan tepi terkemuka. Pemanggil diatur ke NULL jika nilai ini tidak diminta.

Nilai kembali

Mengembalikan STATUS_SUCCESS jika jumlah yang diminta telah diambil. Status pengembalian yang gagal menunjukkan bahwa Pin tidak memiliki antrean terkait.

Keterangan

Pin non-tempat harus menggunakan InputDataBytes untuk pin input dan OutputBufferBytes untuk pin output.

Hasil panggilan ini tidak dijamin aman kecuali mutex pemrosesan diadakan pada waktu panggilan, atau pemanggil telah disinkronkan secara privat sebelum memanggil rutinitas. Untuk menyinkronkan privat, pastikan bahwa pin tidak beralih dari Perolehan ke Berhenti saat rutinitas dijalankan. Lihat Memproses Mutex di AVStream.

Perhatikan juga bahwa transformasi di tempat dapat menyediakan jumlah input dan output.

Di Windows XP dan DirectX 8.0, jumlah InputDataBytes tidak valid kecuali bingkai yang diterima filter penuh.

Untuk informasi tambahan, lihat Pointer Stream Tepi Depan dan Berikutnya.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Tersedia di Microsoft Windows XP dan sistem operasi yang lebih baru dan DirectX 8.0 dan versi DirectX yang lebih baru.
Target Platform	Universal
Header	ks.h (termasuk Ks.h)
Pustaka	Ks.lib