Fungsi KsAddDevice (ks.h)
FungsiKsAddDevice adalah handler AddDevice default yang diinstal oleh KsInitializeDriver.
Sintaksis
KSDDKAPI NTSTATUS KsAddDevice(
[in] PDRIVER_OBJECT DriverObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject
);
Parameter
[in] DriverObject
Penunjuk ke objek driver WDM untuk minidriver.
[in] PhysicalDeviceObject
Penunjuk ke objek perangkat fisik WDM.
Mengembalikan nilai
Mengembalikan STATUS_SUCCESS yang menunjukkan perangkat berhasil dibuat atau status kesalahan dari IoCreateDevice atau KsInitializeDevice.
Komentar
Biasanya, minidriver AVStream tidak memanggil fungsi ini secara langsung.
Untuk informasi selengkapnya, lihat AddDevice Routine untuk AVStream Minidrivers.
KsAddDevice mengekstrak deskriptor perangkat yang disimpan dalam ekstensi perangkat yang dialokasikan dari panggilan ke KsInitializeDriver dan membuat perangkat yang dijelaskan olehnya. Jika KsInitializeDriver tidak digunakan untuk menginisialisasi driver, fungsi ini membuat perangkat dengan karakteristik default dan tidak ada pabrik filter. Minidriver selalu memiliki opsi untuk memanggil KsCreateDevice secara langsung, dalam hal ini ekstensi driver tidak digunakan oleh AVStream. Karena KsAddDevice memanggil KsCreateDevice, driver yang memanggil KsAddDevice tidak boleh memanggil KsCreateDevice secara terpisah.
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 |