Fungsi KsFilterFactoryAddCreateItem (ks.h)
Fungsi KsFilterFactoryAddCreateItem menambahkan item buat baru untuk pabrik filter yang ditentukan.
Sintaks
KSDDKAPI NTSTATUS KsFilterFactoryAddCreateItem(
[in] PKSFILTERFACTORY FilterFactory,
[in] PWSTR RefString,
[in, optional] PSECURITY_DESCRIPTOR SecurityDescriptor,
[in] ULONG CreateItemFlags
);
Parameter
[in] FilterFactory
Penunjuk ke struktur KSFILTERFACTORY yang mewakili pabrik filter untuk menambahkan item buat baru.
[in] RefString
Penunjuk ke string teks Unicode yang mengidentifikasi item buat.
[in, optional] SecurityDescriptor
Parameter ini secara opsional berisi penunjuk ke struktur SECURITY_DESCRIPTOR untuk jenis objek ini. Lihat Microsoft Windows SDK Untuk informasi tentang struktur ini. Untuk informasi terkait, lihat KSOBJECT_CREATE_ITEM. Jika NULL, tidak ada deskriptor yang ditetapkan.
[in] CreateItemFlags
Lihat tabel untuk anggota BenderaKSOBJECT_CREATE_ITEM.
Nilai kembali
KsFilterFactoryAddCreateItem mengembalikan keberhasilan atau kegagalan upaya untuk menambahkan item buat baru.
Keterangan
Biasanya, hanya satu item buat menggunakan GUID referensi yang disediakan dalam deskriptor filter yang ditambahkan untuk pabrik filter. Fungsi ini memungkinkan pemanggil untuk menambahkan item buat yang terkait dengan pabrik filter yang diberikan.
Untuk informasi selengkapnya, lihat Menginisialisasi AVStream Minidriver.
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 |
Lihat juga
KsAddObjectCreateItemToDeviceHeader