Fungsi KsStreamPointerAdvance (ks.h)

  • Artikel

Fungsi KsStreamPointerAdvance memajukan penunjuk aliran ke bingkai data berikutnya.

Sintaks

KSDDKAPI NTSTATUS KsStreamPointerAdvance(
  [in] PKSSTREAM_POINTER StreamPointer
);

Parameter

[in] StreamPointer

Penunjuk ke struktur KSSTREAM_POINTER yang mewakili penunjuk aliran untuk maju mereferensikan bingkai data berikutnya yang tersedia.

Nilai kembali

KsStreamPointerAdvance mengembalikan STATUS_SUCCESS untuk menunjukkan kemajuan yang berhasil. Ini mengembalikan kode kesalahan jika tidak. STATUS_DEVICE_NOT_READY adalah kode kesalahan yang paling sering dikembalikan dan sering menunjukkan bahwa mengunci penunjuk aliran setelah kemajuan gagal. Dengan kata lain, StreamPointer mereferensikan bingkai terakhir dalam antrean.

Keterangan

Jika StreamPointer dikunci pada waktu panggilan, AVStream membukanya sebelum memajukannya. Setelah tingkat lanjut, penunjuk aliran ditempatkan kembali ke keadaan aslinya (terkunci atau tidak terkunci) pada bingkai baru.

Upaya untuk memajukan penunjuk aliran yang tidak terkunci selalu berhasil dan mengembalikan STATUS_SUCCESS. Karena penunjuk aliran tidak dikunci, tidak ada cara untuk menentukan apakah penunjuk aliran mereferensikan data aktual. Minidriver harus mencoba kunci untuk menentukan apakah penunjuk aliran yang baru tingkat lanjut mereferensikan bingkai data atau tidak.

Lihat juga Stream Pointer.

Persyaratan

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

Lihat juga

KSSTREAM_POINTER

KsStreamPointerAdvanceOffsets

KsStreamPointerAdvanceOffsetsAndUnlock

KsStreamPointerLock

KsStreamPointerUnlock