Fungsi KsInitializeDriver (ks.h)

Artikel
02/29/2024

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