Fungsi KsInitializeDevice (ks.h)

Artikel
02/26/2024

Fungsi KsInitializeDevice dipanggil oleh AVStream untuk menginisialisasi kelas perangkat AVStream dari dalam KsCreateDevice.

Sintaks

KSDDKAPI NTSTATUS KsInitializeDevice(
  [in]           PDEVICE_OBJECT            FunctionalDeviceObject,
  [in]           PDEVICE_OBJECT            PhysicalDeviceObject,
  [in]           PDEVICE_OBJECT            NextDeviceObject,
  [in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);

Parameter

[in] FunctionalDeviceObject

Penunjuk ke struktur DEVICE_OBJECT yang mewakili objek perangkat fungsi WDM untuk perangkat yang sedang diinisialisasi.

Biasanya, ini dikembalikan dari panggilan IoCreateDevice . Minidriver yang memanggil fungsi ini secara langsung bertanggung jawab untuk memanggil IoCreateDevice dan melampirkan diri ke tumpukan perangkat.

[in] PhysicalDeviceObject

Penunjuk ke struktur DEVICE_OBJECT yang mewakili objek perangkat fisik WDM untuk perangkat yang sedang diinisialisasi.

[in] NextDeviceObject

Penunjuk ke struktur DEVICE_OBJECT berikutnya di tumpukan perangkat seperti yang ditentukan oleh panggilan ke IoAttachDeviceToDeviceStack.

[in, optional] Descriptor

Penunjuk ke struktur KSDEVICE_DESCRIPTOR yang menjelaskan karakteristik perangkat yang sedang diinisialisasi. Jika parameter ini NULL, perangkat diinisialisasi dengan karakteristik default dan tidak memiliki pabrik filter terkait.

Nilai kembali

KsInitializeDevice mengembalikan STATUS_SUCCESS jika perangkat berhasil diinisialisasi. Jika tidak, ia mengembalikan kode kesalahan yang sesuai.

Keterangan

Sebagian besar minidriver tidak memanggil fungsi ini secara langsung. Hanya panggil KsInitializeDevice jika minidriver Anda tidak menggunakan KsInitializeDriver untuk inisialisasi, menangani AddDevice secara independen, dan tidak menggunakan KsAddDevice atau KsCreateDevice di handler AddDevice-nya .

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