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