共用方式為


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,指出裝置已成功建立,或從 IoCreateDeviceKsInitializeDevice的錯誤狀態。

言論

一般而言,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

另請參閱

DEVICE_OBJECT

DRIVER_OBJECT

KSDEVICE

KsCreateDevice

KsDispatchIrp

KsInitializeDevice

KsInitializeDriver