Fungsi KsInitializeDriver (ks.h)
Fungsi KsInitializeDriver menginisialisasi objek driver dari minidriver AVStream.
Sintaks
KSDDKAPI NTSTATUS KsInitializeDriver(
[in] PDRIVER_OBJECT DriverObject,
[in] PUNICODE_STRING RegistryPathName,
[in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);
Parameter
[in] DriverObject
Penunjuk ke struktur DRIVER_OBJECT untuk driver AVStream yang sedang diinisialisasi. Minidriver yang memanggil KsInitializeDriver harus menggunakan objek driver yang diteruskan ke DriverEntry oleh sistem operasi.
[in] RegistryPathName
Penunjuk ke string Unicode yang berisi string jalur registri yang diteruskan ke fungsi DriverEntry minidriver oleh sistem operasi.
[in, optional] Descriptor
Penunjuk ke struktur KSDEVICE_DESCRIPTOR yang menentukan karakteristik perangkat yang sedang diinisialisasi. Jika pointer ini NULL, perangkat dibuat dengan karakteristik default dan tidak ada pabrik filter terkait.
Nilai kembali
KsInitializeDriver mengembalikan STATUS_SUCCESS atau kode kesalahan yang sesuai seperti yang dikembalikan oleh IoCreateDevice atau rutinitas inisialisasi perangkat AVStream internal.
Keterangan
Fungsi ini biasanya disebut dari DriverEntry. Jika minidriver melewati deskriptor perangkat, AVStream membuat perangkat dengan karakteristik yang ditentukan pada waktu AddDevice . Minidriver yang melakukan inisialisasi perangkat itu sendiri tidak perlu memanggil KsInitializeDriver. 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 dan DirectX 8.0 dan versi DirectX yang lebih baru. |
| Target Platform | Universal |
| Header | ks.h (termasuk Ks.h) |
| Pustaka | Ks.lib |
| IRQL | PASSIVE_LEVEL |