KsAddDevice 函式 (ks.h)
KsAddDevice 函式是 KsInitializeDriver所安裝的預設 AddDevice 處理程式。
語法
KSDDKAPI NTSTATUS KsAddDevice(
[in] PDRIVER_OBJECT DriverObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject
);
參數
[in] DriverObject
迷你驅動程式之 WDM 驅動程式物件的指標。
[in] PhysicalDeviceObject
WDM 實體裝置物件的指標。
傳回值
傳回STATUS_SUCCESS,指出裝置已成功建立,或從 IoCreateDevice 或 KsInitializeDevice的錯誤狀態。
言論
一般而言,AVStream 迷你驅動程式不會直接呼叫此函式。
如需詳細資訊,請參閱 AVStream Minidrivers的 AddDevice 例程。
KsAddDevice 擷取儲存在從呼叫配置給 KsInitializeDriver 之裝置擴充功能中的裝置描述元, 並建立其描述的裝置。 如果 KsInitializeDriver 未用來初始化驅動程式,則此函式會建立具有預設特性且沒有篩選站的裝置。 minidriver 一律可以選擇直接呼叫 KsCreateDevice,在此情況下,AVStream 不會使用驅動程序擴充功能。 因為 KsAddDevice 呼叫 KsCreateDevice,因此呼叫 KsAddDevice 的驅動程式不應該分別呼叫 KsCreateDevice。
要求
要求 | 價值 |
---|---|
最低支援的用戶端 | Microsoft Windows XP 和更新版本的作系統和 DirectX 8.0 和更新版本的 DirectX 版本中提供。 |
目標平臺 | 普遍 |
標頭 | ks.h (包括 Ks.h) |
連結庫 | Ks.lib |
IRQL | PASSIVE_LEVEL |