Fungsi KsStreamPointerClone (ks.h)

Artikel
02/27/2024

Fungsi KsStreamPointerClone membuat kloning penunjuk aliran tertentu.

Sintaks

KSDDKAPI NTSTATUS KsStreamPointerClone(
  [in]           PKSSTREAM_POINTER  StreamPointer,
  [in, optional] PFNKSSTREAMPOINTER CancelCallback,
  [in]           ULONG              ContextSize,
  [out]          PKSSTREAM_POINTER  *CloneStreamPointer
);

Parameter

[in] StreamPointer

Penunjuk ke struktur KSSTREAM_POINTER yang mewakili penunjuk aliran yang akan dikloning.

[in, optional] CancelCallback

Opsional. Pointer ke rutinitas AVStrMiniCancelCallback yang disediakan minidriver. AVStream memanggil rutinitas ini jika IRP yang terkait dengan CloneStreamPointer dibatalkan.

[in] ContextSize

Parameter ini menunjukkan berapa banyak byte informasi konteks minidriver yang harus dimiliki oleh penunjuk aliran kloning yang dihasilkan. Jika bukan nol, jumlah byte yang diminta dialokasikan segera setelah penunjuk aliran yang dikembalikan, dan bidang KonteksCloneStreamPointer menunjuk ke memori yang dialokasikan.

[out] CloneStreamPointer

Penunjuk ke penunjuk ke struktur KSSTREAM_POINTER . Setelah berhasil menyelesaikan operasi kloning, CloneStreamPointer berisi penunjuk ke alamat penunjuk aliran yang dikloning.

Nilai kembali

KsStreamPointerClone mengembalikan STATUS_SUCCESS, menunjukkan bahwa operasi kloning selesai secara normal, atau kode kesalahan yang sesuai.

Keterangan

Kloning yang dihasilkan awalnya mengacu pada bingkai data yang sama dengan penunjuk aliran asli dan dalam keadaan yang sama (terkunci atau tidak terkunci). Menambahkan penunjuk aliran kloning yang mereferensikan bingkai data menambah jumlah referensi pada bingkai tertentu. Perhatikan bahwa bingkai yang dimaksud, dan oleh karena itu IRP tempat bingkai berada, tidak selesai sampai jumlah referensi turun ke nol.

Anda dapat menggunakan parameter ContextSize dari panggilan ini untuk meminimalkan panggilan alokasi.

Lihat juga Stream Pointers.

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