Fungsi KsPinGetLeadingEdgeStreamPointer (ks.h)

Artikel
08/07/2023

Fungsi KsPinGetLeadingEdgeStreamPointer memperoleh penunjuk aliran tepi terkemuka untuk antrean yang terkait dengan pin yang diberikan.

Sintaks

KSDDKAPI PKSSTREAM_POINTER KsPinGetLeadingEdgeStreamPointer(
  [in] PKSPIN                 Pin,
  [in] KSSTREAM_POINTER_STATE State
);

Parameter

[in] Pin

Penunjuk ke struktur KSPIN yang memiliki antrean tempat penunjuk aliran tepi terkemuka harus diperoleh.

[in] State

Parameter ini menentukan cara memperoleh penunjuk aliran tepi terkemuka. Bisa jadi salah satu dari yang berikut:

KSSTREAM_POINTER_STATE_UNLOCKED

Dapatkan penunjuk aliran tepi terkemuka terlepas dari apakah itu mereferensikan bingkai data atau tidak.

Tidak ada upaya yang dapat dilakukan untuk mengakses data apa pun yang terkait dengan penunjuk hingga penunjuk dikunci. Perhatikan juga bahwa bingkai yang terkait dengan penunjuk aliran yang tidak terkunci dapat dibatalkan.

KSSTREAM_POINTER_STATE_LOCKED

Memperoleh dan mengunci penunjuk aliran tepi terkemuka. Jika tidak ada bingkai data yang terkait dengan penunjuk aliran, kembalikan NULL. Jika penunjuk bukannull dikembalikan, itu adalah penunjuk aliran terkunci dan memiliki bingkai data yang terkait dengannya. Bingkai yang terkait dengan penunjuk aliran terkunci tidak dapat dibatalkan.

Nilai kembali

KsPinGetLeadingEdgeStreamPointer mengembalikan penunjuk ke struktur KSSTREAM_POINTER atau NULL. Nilai pengembalian NULL dapat terjadi karena tidak ada antrean yang terkait dengan pin, yang menunjukkan bahwa pin tidak menggunakan mekanisme transportasi standar. Atau, nilai pengembalian NULL dapat terjadi karena upaya untuk mengunci tepi depan gagal, menunjukkan bahwa tidak ada bingkai data yang terkait dengan tepi depan.

Keterangan

Filter yang mengimplementasikan Pemrosesan Pin-Centric sering memanggil KsPinGetLeadingEdgeStreamPointer.

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
IRQL	<=DISPATCH_LEVEL