Fungsi KsGetParent (ks.h)
Fungsi KsGetParent memperoleh induk objek yang diberikan.
Sintaksis
KSDDKAPI PVOID KsGetParent(
[in] PVOID Object
);
Parameter
[in] Object
Penunjuk ke objek AVStream untuk menemukan induknya. Harus menjadi penunjuk ke salah satu jenis berikut: KSDEVICE, KSFILTERFACTORY, KSFILTER, atau KSPIN. Penelepon harus mengetik objek secara manual ke PVOID.
Mengembalikan nilai
KsGetParent mengembalikan induk Objek sebagai PVOID. Penelepon harus secara manual melemparkan nilai pengembalian ini ke apa pun jenis induk Object.
Komentar
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 Mutexes 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
| Syarat | 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. |
| Platform Target | Universal |
| Header | ks.h (termasuk Ks.h) |
| Pustaka | Ks.lib |
| IRQL | PASSIVE_LEVEL |
Lihat juga
KsFilterFactoryGetParentDevice