Fungsi KsGetParent (ks.h)

Artikel
02/26/2024

Fungsi KsGetParent memperoleh induk dari objek yang diberikan.

Sintaks

KSDDKAPI PVOID KsGetParent(
  [in] PVOID Object
);

Parameter

[in] Object

Penunjuk ke objek AVStream untuk menemukan induknya. Harus berupa pointer ke salah satu jenis berikut: KSDEVICE, KSFILTERFACTORY, KSFILTER, atau KSPIN. Penelepon harus mengetik objek secara manual ke PVOID.

Nilai kembali

KsGetParent mengembalikan induk Objek sebagai PVOID. Penelepon harus secara manual melemparkan nilai pengembalian ini ke apa pun jenis induk Objek .

Keterangan

Untuk representasi grafis hubungan induk/anak AVStream, lihat diagram dalam Hierarki Objek AVStream.

Hierarki objek hanya dijamin stabil sementara mutex yang sesuai ditahan, dalam hal ini mutex perangkat. Untuk informasi selengkapnya, lihat Mutex di AVStream.

Minidriver jarang menggunakan fungsi ini secara langsung. Pemanggil KsGetParent harus melakukan typecast secara manual ke dan dari PVOID. Ada sejumlah versi sebaris yang melakukan transmisi untuk Anda: KsFilterFactoryGetParentDevice, KsFilterGetParentFilterFactory, dan KsPinGetParentFilter.

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	PASSIVE_LEVEL